Create a webhook subscription
POST/api/v1/webhooks/create-subscription
Creates a new event subscription on an existing webhook endpoint. The subscription filters events by the specified event types and delivers matching events to the endpoint URL.
One subscription per endpoint
Only one live subscription is allowed per endpoint; a second fails with ALREADY_EXISTS. There is no public update-subscription operation. Delete the old subscription and create its replacement when a delivery gap is acceptable.
Request
Responses
- 200
Subscription created successfully
Document ID: DOC-IN-webhooks-api-createWebhookSubscription. Section identities and revisions.
| Section | Stable reference |
|---|---|
| Overview | DOC-IN-webhooks-api-createWebhookSubscription#overview |
| Request | DOC-IN-webhooks-api-createWebhookSubscription#request |
| Responses | DOC-IN-webhooks-api-createWebhookSubscription#responses |