This endpoint creates a new Product Review.

By default, Product Reviews are created as inactive (meaning you'll need to manually activate/publish them in your REVIEWS.io dashboard) and only 3 product reviews can be submitted by a single IP address in a 30 minute period. Providing your REVIEWS.io API key removes these restrictions but please ensure that you're not publicly exposing your API key.

Submitting Attributes

Review Attributes (Sub-ratings)

Submit additional numeric ratings for a product review. The question must already exist for the store.

Option 1: ratings (by question text)

Pass a JSON object keyed by question text with numeric values:

&ratings[Quality]=4&ratings[Value for Money]=5

Or in a JSON body:

{
  "ratings": {
    "Quality": 4,
    "Value for Money": 5
  }
}

• Maximum 10 sub-ratings per request
• Question text must exactly match the configured question

Option 2: additional_rating (by question text)

Pass as a JSON object keyed by question text:

{
  "additional_rating": {
    "Quality": 4,
    "Value for Money": 5
  }
}

• Silently skipped if the question text does not match

Note: ratings and additional_rating are independent parameters — both can be provided in the same request. When additional_rating is passed using both ID and text formats, the ID format takes priority; the text format is only used if no IDs matched.

Reviewer Attributes

Submit text-based metadata about the reviewer. The question must already exist for the store.

Pass as a JSON object keyed by question text:

{
  "attribute": {
    "How is the fit?": "Perfect",
    "Age Range": "Over 30"
  }
}

• Question text must exactly match the configured question
• If the reviewer already has an answer for the same question, it is updated rather than duplicated