Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

Create Webhook

POST

https://api.zid.sa/v1/managers/webhooks

Webhooks allow you to receive real-time data updates about various events.
For certain events, you can specify conditions under which the webhook should trigger,
allowing for more targeted data retrieval.

Supported Webhook Events

For more details on available events and their conditions,
please refer to the Supported Webhook Events page.

🔑Scopes

webhooks.read_write - Webhooks Read & Write

Request

Header Params

Body Params application/json

Example

{
    "event": "category.create",
    "target_url": "https://webhook.site/79b40fa4-ace1-4589-882d-d30f16281f20",
    "original_id": 2404,
    "conditions": {}
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.zid.sa/v1/managers/webhooks' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en' \
--header 'Content-Type: application/json' \
--data-raw '{
    "event": "category.create",
    "target_url": "https://webhook.site/79b40fa4-ace1-4589-882d-d30f16281f20",
    "original_id": 2404,
    "conditions": {}
}'

Responses

🟢200OK

application/json

Body

Example

{
    "status": "string",
    "id": "string",
    "event": "string",
    "target_url": "string",
    "store_id": "string",
    "conditions": [
        "string"
    ],
    "original_id": "string",
    "subscriber": "string",
    "active": true,
    "message": {
        "type": "object",
        "code": "string",
        "name": "string",
        "description": "string"
    }
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-01-30 23:01:56

List Webhooks

Delete Webhook

Create Webhook

Supported Webhook Events#

Request

Request Code Samples

Responses

Supported Webhook Events