---
title: "Create a new Product Review"
method: POST
path: "/product/review/new"
tags: ["Reviews and Questions"]
---

# Create a new Product Review

`POST /product/review/new`

## Request

- Base URL: `https://api.reviews.io`
- URL: `https://api.reviews.io/product/review/new`
- Auth: none declared
- TypeScript: <https://skmtc.dev/reviews/apis/reviews-io-api/docs/product/review/new/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `store` string, required
- `apikey` string

## Request body

- ProductReview: Review of a product
  - `sku` string, required: Product Identifier
  - `name` string, required: Reviewers Name
  - `email` string, required: Reviewers email address
  - `rating` string, required: Review rating
  - `order_id` string: Reviewer order reference
  - `review` string, required: Review comments
  - `tags` string: Add tag(s) to your review (must be comma-separated)
  - `address` string: Reviewers location
  - `ip_address` string: Reviewers IP Address
  - `images` ProductReviewImage[]: Images uploaded with the product review
    - `url` string, required: Url of photo
    - `status` 'active' | 'inactive': Status of image (active or inactive)
  - `ratings` object: Additional sub-ratings on a product review (Quality, Value for Money, etc). Supports multiple formats: ratings[Quality]=4, additional_rating[42]=4 (by ID), or additional_rating JSON. Max 10 sub-ratings per request. When passed by both ID and JSON, the ID format takes priority.
  - `attribute` object: Descriptive metadata about the reviewer/user (Age Range, Skin Type, etc). Supports formats: attribute[7]=Perfect (by ID) or attribute JSON. When passed by both ID and JSON, the ID format takes priority.

## Response `200`

OK

- object

---

[API](https://skmtc.dev/reviews/apis/reviews-io-api.md) - [All operations](https://skmtc.dev/reviews/apis/reviews-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/reviews/apis/reviews-io-api/revisions/ea87e0d855cc?raw)