Skip to main content
POST
/
reviews
/
with-media
{
  "success": true,
  "data": {}
}
POST {BASE_URL}/reviews/with-media
The API creates your review immediately with mediaStatus: "processing". Media processes in the background. A media failure does not roll back the review.

​
Body parameters

This endpoint uses multipart/form-data encoding. Send all fields as form values, not JSON.
​
productId
string
required
Product ID.
​
rating
string
required
1–5.
​
authorName
string
required
Customer display name.
​
authorEmail
string
required
Customer email.
​
file
file
Image or video. Repeat key for multiple files. Max 50 MB each.
​
title
string
Review headline.
​
text
string
Review body.
​
orderId
string
Order ID for verified purchase.
​
incentiveClaimId
string
Incentive claim ID.
​
incentiveConsent
string
"true" to confirm FTC disclosure.
​
wouldRecommend
string
"true" or "false".
​
pros
string
Free-text pros.
​
cons
string
Free-text cons.
​
attributes
string
Custom attributes as a JSON-stringified string, e.g., '{"fit":"true_to_size"}'.

​
Example

curl -X POST "${RF_BASE_URL}/reviews/with-media" \
  -H "X-Merchant-Id: YOUR_MERCHANT_ID" \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "productId=SKU-001" -F "rating=5" \
  -F "authorName=Jane Doe" -F "authorEmail=jane@example.com" \
  -F "file=@/path/to/photo.jpg"

Headers

​
X-Merchant-Id
string
​
X-API-Key
string

Response

Successful response

​
success
boolean
required
Example:

true

​
data
object