Skip to main content
POST
/
reviews
Submit Review
curl --request POST \
  --url https://cdn.tailoredd.com/apiV2/reviews \
  --header 'Content-Type: application/json' \
  --data '
{
  "productId": "product-123",
  "merchantId": "your-merchant-id",
  "rating": 5,
  "title": "Great product!",
  "text": "I really love this product, highly recommended!",
  "authorName": "John Doe",
  "authorEmail": "john@example.com",
  "orderId": "order-sample-001",
  "incentiveClaimId": "claim-xyz789",
  "incentiveConsent": true,
  "wouldRecommend": true,
  "pros": "Fast shipping, great quality",
  "cons": "Packaging could be better",
  "attributes": {
    "fit": "true_to_size",
    "quality": "excellent",
    "delivery": "fast",
    "packaging": "good"
  }
}
'
{
  "success": true,
  "data": {}
}
POST {BASE_URL}/reviews

​
Body parameters

​
productId
string
required
Product being reviewed.
​
merchantId
string
required
Your merchant ID.
​
rating
integer
required
1–5 star rating.
​
authorName
string
required
Customer display name.
​
authorEmail
string
required
Customer email.
​
title
string
Review headline.
​
text
string
Review body.
​
orderId
string
Order ID to mark as verified purchase.
​
incentiveClaimId
string
Incentive claim ID.
​
incentiveConsent
boolean
FTC disclosure accepted.
​
wouldRecommend
boolean
Recommendation flag.
​
pros
string
Free-text pros.
​
cons
string
Free-text cons.
​
attributes
object
Custom attribute key/value pairs.

​
Example

{
  "productId": "SKU-001", "merchantId": "YOUR_MERCHANT_ID",
  "rating": 5, "title": "Best purchase this year",
  "text": "Quality exceeded expectations!",
  "authorName": "James T.", "authorEmail": "james@example.com",
  "orderId": "ORDER-10045", "wouldRecommend": true,
  "pros": "Fast shipping, great quality",
  "attributes": { "fit": "true_to_size", "quality": "excellent" }
}

Headers

​
Authorization
string

Optional - for authenticated submissions

Body

application/json

The body is of type object.

Response

Successful response

​
success
boolean
required
Example:

true

​
data
object