---
title: "POST /v2/reviews/{platform}"
method: POST
path: "/v2/reviews/{platform}"
tags: ["reviews"]
---

# POST /v2/reviews/{platform}

`POST /v2/reviews/{platform}`

## Path parameters

- `platform` string, required

## Query parameters

- `site_id` number

## Request body

- ReviewsCreateReviewRequestBody
  - `merchant_id` string, required — The ID of the review in your review platform
  - `customer` object, required — The customer who left the review
    - `merchant_id` string, required — The ID of the customer in your platform or ecommerce store. If you are a review partner, this must be the ID of the customer in the connected store, e.g. a Shopify customer ID
    - `email` string, email, required — The email address of the customer
  - `status` 'approved' | 'flagged' | 'pending' | 'rejected', required — The current status of the review, which determines how and when associated rules are triggered. One of: `pending` (the review is pending review), `flagged` (the review has been flagged for review), `approved` (the review has been approved/published), `rejected` (the review has been rejected)
  - `full_text` string, required — The full text of the review
  - `rating` number, required — The rating given in the review
  - `images_count` number, required — The number of images attached to the review
  - `videos_count` number, required — The number of videos attached to the review
  - `date` string, required — The date this review was created in the review platform, as an ISO 8601 timestamp
  - `product_merchant_id` string, nullable — If this review was for a specific product, this should be set to the product ID in your ecommerce platform. If you are a review partner, this must be the ID of the product in the connected store, e.g. a Shopify product ID
  - `moderation_url` string, uri, nullable — Optional URL to moderate the review in the review platform

## Response `201`

201

- ReviewsCreateReviewResponseBody
  - `review` object, required
    - `id` number, required — Unique ID of the review in LoyaltyLion
    - `program_id` number, required — The LoyaltyLion program to which this review belongs
    - `customer` object, required — The customer who left the review
      - `id` number, required — ID of the customer in LoyaltyLion
      - `email` string, nullable, required — The email address of the customer
    - `site_id` number, nullable, required — The LoyaltyLion site this review belongs to, or `null` if not linked to a site
    - `platform` string, required — The review platform this review originates from
    - `merchant_id` string, required — The ID of the review in the review platform
    - `status` 'approved' | 'flagged' | 'pending' | 'rejected', required — The current status of the review, which determines how and when associated rules are triggered. One of: `pending` (the review is pending review), `flagged` (the review has been flagged for review), `approved` (the review has been approved/published), `rejected` (the review has been rejected)
    - `full_text` string, required — The full text of the review
    - `rating` number, required — The rating given in the review
    - `images_count` number, required — The number of images attached to the review
    - `videos_count` number, required — The number of videos attached to the review
    - `merchant_created_at` string, required — ISO 8601 timestamp representing the date this review was created in the review platform
    - `merchant_updated_at` string, required — ISO 8601 timestamp representing the date this review was last updated in the review platform
    - `moderation_url` string, nullable, required — The URL to moderate the review in the review platform

## Other responses

- `400` — Bad Request
- `401` — 401
- `403` — 403
- `422` — 422
- `429` — 429

---

[API](https://skmtc.net/loyaltylion/apis/loyaltylion-admin-api.md) · [All operations](https://skmtc.net/loyaltylion/apis/loyaltylion-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyaltylion/loyaltylion-admin-api/revisions/4cfed13b45bc/schema)