Create Webhook Subscription
Creates a webhook subscription for the authenticated user’s entity and returns its signing secret. The secret is shown only in this response; store it securely. Every delivery to the subscription’s path is signed following the Standard Webhooks specification: the webhook-id header uniquely identifies the delivery, webhook-timestamp is unix seconds, and webhook-signature is a space-separated list of v1,<base64 HMAC-SHA256> entries; accept the delivery when any entry matches (two are sent for 24 hours after a rotation). The signed content is <webhook-id>.<webhook-timestamp>.<raw request body> and the HMAC key is the base64-decoded secret (strip the whsec_ prefix first). Compare signatures in constant time, reject a timestamp more than 300 seconds from your clock, and de-duplicate on webhook-id. When several subscriptions share one URL, the webhookSubscriptionId in the delivery body says which secret to verify with. Rotate the secret with POST /webhooks/subscriptions//signing-secret.
signingSecret in the response is shown only once. Store it securely
and use it to verify every
delivery.
The path must be an https URL.Authorizations
Body
Webhook subscription creation request
Response
Webhook subscription created successfully