Create Public Product Review (v1)

Method & Path

POST /api/v1/public/storefront/stores/:slug/products/:productId/reviews

Actual backend path: /v1/public/storefront/stores/:slug/products/:productId/reviews

Description

Creates a product review (1–5 stars, optional name and comment). The store must be published. Initial status is visible if productReviewsAutoPublish is enabled on the store, otherwise pending until moderated in the dashboard.

Authentication

None (public).

Personas: Customer (client).

Request Body

{
  "rating": 5,
  "comment": "Very good",
  "authorName": "Ali"
}

Field	Type	Required	Description
rating	integer	Yes	1–5
comment	string | null	No	Max 2000 characters
authorName	string | null	No	Max 80 characters

Response 201 Created

{
  "review": {
    "id": "…",
    "rating": 5,
    "comment": "Very good",
    "authorName": "Ali",
    "createdAt": "2026-04-05T10:00:00.000Z"
  },
  "moderationStatus": "pending"
}

moderationStatus is visible or pending.

Common Errors

• 404 Not Found: Store not published, or product not found
• 422 Unprocessable Entity: Invalid rating or field length
• 400 Bad Request: Invalid JSON