createReview
Create a new review record for a member. Use for importing legacy reviews or adding test data. Requires user ID and reviewer email.
Instructions
Create a review - Create a new review record. Writes live data.
Use when: importing legacy reviews from another platform, adding placeholder reviews for test data, or scripting review submissions from an external integration. Real member-submitted reviews come through the BD review form - only use this API when bypassing that form.
Required: user_id, review_email.
Parameter interactions:
user_id- the member being reviewedrating_overall: integer 1-5 (higher = better)recommend:0=No,1=Yes (shown as a thumbs-up recommendation flag)review_statuscontrols initial visibility - default flow is0Pending -> admin review
See also: updateReview (modify existing).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_id | Yes | ||
| review_name | No | Reviewer's display name. Strongly recommended - most BD themes render this on the profile next to the review. | |
| review_email | Yes | REQUIRED (server rejects with `The review email is required` when omitted, despite earlier docs that listed only `user_id` as required). Reviewer's email. Used for notification threading and duplicate-review detection. | |
| review_title | No | ||
| review_description | No | ||
| rating_overall | No | ||
| recommend | No | ||
| review_status | No | Review status (integer). Authoritative values from BD admin: 0 = Pending (newly submitted, awaiting moderation - default for new reviews) 2 = Accepted (approved and visible on the member profile) 3 = Declined (rejected by admin - not publicly visible) 4 = Waiting for Admin (member pre-accepted, admin sign-off required) Value 1 is NOT a documented status - **but BD does NOT reject it. Passing `1` stores `"1"` verbatim with undefined render behavior.** Stick to the documented set. On create, default flow starts at 0. |