Skip to main content

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​

Subscription created successfully

Document ID: DOC-IN-webhooks-api-createWebhookSubscription. Section identities and revisions.

SectionStable reference
OverviewDOC-IN-webhooks-api-createWebhookSubscription#overview
RequestDOC-IN-webhooks-api-createWebhookSubscription#request
ResponsesDOC-IN-webhooks-api-createWebhookSubscription#responses