Skip to main content
POST
Create a supplier review (1–5 star rating with optional comment)

Authorizations

x-api-key
string
header
required

API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.

Path Parameters

projectId
string
required

The project (tenant) that owns the resource. Every resource in this API is scoped to a project, and your API key is restricted to the projects it was issued for — a project outside that scope returns 403.

Minimum string length: 1
Example:

"prj_01kv60qgnef2kt3pvqgwmkbzfr"

Body

application/json

Review data

supplierId
string
required
Minimum string length: 1
ratingStars
integer
required
Required range: 1 <= x <= 5
reviewText
string
Maximum string length: 5000
reviewerId
string
bookingId
string

Optional booking this review is about. Supplying it links the review to that booking and stops the rating follow-up emails for it. Stored as given and not validated against the booking, and it does not deduplicate.

Example:

"bk_01kv60qge5eh59ap0gw0pqrrys"

Response

Review created

data
object
required