1. Reviews
TrustWILL
  • Reviews Widget Integration
  • Reviews Data API
    • Trustoo Open API — Quick Start
    • OAuth2
      • OAuth2 Merchant Authorization
      • Get OAuth2 Authorization URL
      • OAuth2 Get / Refresh Access Token
      • Revoke Token
    • Platform Management
      • Disconnect Platform Authorization
      • Get Shop Authorization Info
      • Get Shop Installation Status
      • Cancel Platform Authorization
    • Webhooks
      • Create Shop Webhook
      • Update Shop Webhook
      • Delete Shop Webhook
      • Get Shop Webhooks
    • Reviews
      • Get Review Detail
        GET
      • Get Review List
        GET
      • Create Review
        POST
      • Delete Review
        POST
      • Get Rating
        GET
    • Media Upload
      • Get Video Upload URL
      • Get Image Upload Credentials
    • Orders
      • Get Order List
    • Customer Events
      • Get Customer Event List
    • Customers
      • Email Unsubscribe
      • Create Customer Exclusion
      • Delete Customer Exclusion
      • Get Customer Exclusion List
  • Schemas
    • SuccessResponse
    • ErrorResponse
    • Pagination
    • OAuthTokenRequest
    • Webhook
    • CreateReviewRequest
    • Review
    • Rating
    • Order
    • CustomerEvent
    • CustomerExclusion
    • ImageUploadCredentials
  1. Reviews

Create Review

POST
/api/v1/openapi/create_review
Create a new review for a product or store.
Authentication: HMAC signature OR OAuth2 Bearer Token
Scope: write_reviews

Request

Authorization
API Key
Add parameter in header
Public-Token
Example:
Public-Token: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Body Params application/jsonRequired

Example
{
    "product_id": "9200305176832",
    "rating": 5,
    "author": "Trustoo",
    "author_country": "US",
    "content": "This is a test review via OpenAPI",
    "source": "ChatWILL",
    "media": [
        {
            "url": "https://img.trustoo.io/test/79198486784/2026/5/14/57ca8d51-4d0a-4785-b0e0-24a1b3ac1624.jpeg?x-oss-process=style/trustoo_big",
            "thumbnail_url": "https://img.trustoo.io/test/79198486784/2026/5/14/57ca8d51-4d0a-4785-b0e0-24a1b3ac1624.jpeg?x-oss-process=style/trustoo_small",
            "type": 1,
            "is_published": 1
        }
    ]
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://rapi.trustoo.io/api/v1/openapi/create_review' \
--header 'Sign: 31ff687ec862dbf14cb1a75407e1681b5bde64feb350f545c22f69c095ddbaba' \
--header 'Timestamp: 1779678340' \
--header 'Public-Token: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "product_id": "9200305176832",
    "rating": 5,
    "author": "Trustoo",
    "author_country": "US",
    "content": "This is a test review via OpenAPI",
    "source": "ChatWILL",
    "media": [
        {
            "url": "https://img.trustoo.io/test/79198486784/2026/5/14/57ca8d51-4d0a-4785-b0e0-24a1b3ac1624.jpeg?x-oss-process=style/trustoo_big",
            "thumbnail_url": "https://img.trustoo.io/test/79198486784/2026/5/14/57ca8d51-4d0a-4785-b0e0-24a1b3ac1624.jpeg?x-oss-process=style/trustoo_small",
            "type": 1,
            "is_published": 1
        }
    ]
}'

Responses

🟢200
application/json
Review created
Bodyapplication/json

Example
{
    "code": 0,
    "message": "string",
    "time": 0,
    "request_id": "string",
    "data": {
        "id": "string"
    }
}
Modified at 2026-06-24 04:25:21
Previous
Get Review List
Next
Delete Review
Built with