v1

latestOpenAPI 3.1.02026-07-1325128129.5 KB
webhooks

Create Webhook

Create a new webhook for the authenticated organization to receive event notifications

post/webhooks

Headers

Authorization-Signaturestring required

Authorization header format: 'APIKey=<api_key>,signature=<signature>,timestamp=<unix_timestamp>'

Request body

urlstring required
subscription_eventsstring[]

Example request

{
  "subscription_events": [
    "ORDER_CREATED",
    "ORDER_COMPLETED"
  ],
  "url": "https://example.com/webhook"
}

Response

Webhook created successfully

idstring required
urlstring required
webhook_secretstring
subscription_eventsstring[]
activeboolean required

Example response

{
  "active": true,
  "id": "cuidjkhg3e289y74u5t6v",
  "subscription_events": [
    "ORDER_CREATED",
    "ORDER_COMPLETED"
  ],
  "url": "https://example.com/webhook",
  "webhook_secret": "whsec_xxxxx"
}