Subscribe to order events
POST /v1/webhook_subscriptions
Each event is POSTed to url as JSON, signed with the subscription's secret.
Authentication
Send a token issued in the Zoopit dashboard as Authorization: Bearer <token>.
Request body
| Field | Type | Required |
|---|---|---|
owner | string | yes |
name | string | yes |
url | string | yes |
events | array of WebhookEvent | yes |
enabled | boolean | |
tags | array of string |
Responses
201
resource: CreatedSubscriptionAsJson
| Field | Type | Required |
|---|---|---|
name | string | yes |
url | string | yes |
secret | string | yes |
events | array of WebhookEvent | yes |
enabled | boolean | yes |
id | string | yes |
created_at | string | yes |
modified_at | null or string | yes |
deleted_at | null or string | yes |
created_by | string | yes |
modified_by | null or string | yes |
deleted_by | null or string | yes |
owners | array of string | yes |
tags | array of string | yes |
attributes | object | yes |
Example
curl -X POST 'https://orders-api.cloud.zoopit.no/v1/webhook_subscriptions'
-H 'Authorization: Bearer <token>'
-H 'Content-Type: application/json'
-d '{ ... }'
Try it in the interactive Orders API reference.
Field descriptions, guides and worked examples are in the full reference, available to customers in the Zoopit dashboard under Accounts → Developer.