Create Shop Webhook

POST

/api/v1/openapi/create_shop_webhook

Register a webhook subscription for real-time event notifications. The webhook is scoped to the authenticated shop or platform.

Authentication: HMAC signature OR OAuth2 Bearer Token
Scope: Depends on topic — see topic-to-scope mapping below

Topic	Required Scope
review/created	write_reviews
review/updated	write_reviews
review/deleted	write_reviews
customer_event/created	read_customer_events

Platform isolation: When using OAuth2 Bearer Token, the webhook is scoped to the platform (platform_id). When using HMAC, it is scoped to the shop only (platform_id = 0).

Request

Header Params

Body Params application/jsonRequired

Example

{
    "topic": "review/created",
    "url": "https://marketing.puffy.team/api/trustoo-reviews"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://rapi.trustoo.io/api/v1/openapi/create_shop_webhook' \
--header 'Public-Token: y38VaL5SEpRwr0' \
--header 'Sign: 1885989a2470e1c47d1d26e7afc09d99d9ebac4981bae07bef3d24ca947c9d52' \
--header 'Timestamp: 1790358055' \
--header 'Content-Type: application/json' \
--data '{
    "topic": "review/created",
    "url": "https://marketing.puffy.team/api/trustoo-reviews"
}'

Responses

🟢200

application/json

Webhook created

Bodyapplication/json

Example

{
    "code": 0,
    "message": "success",
    "time": 1750417608,
    "request_id": "dbf9af0f0436ee4f86ebee64e3828555",
    "data": {
        "id": "19",
        "topic": "review/created",
        "url": "https://api.example.com/webhook",
        "created_at": "2025-06-20T11:06:48Z",
        "updated_at": "2025-06-20T11:06:48Z"
    }
}

Modified at 2026-09-25 17:42:21

Cancel Platform Authorization

Update Shop Webhook