Webhooks

Use the operations below to work with webhooks. Each link opens an interactive reference page generated from the published OpenAPI specification.

Operations

Operation	Method and path	Required scopes
List this credential’s webhook subscriptions	`GET /v1/webhooks`	`webhooks.read`
Subscribe to an event. Returns the signing secret ONCE. Re-subscribing the same event and URL is idempotent	`POST /v1/webhooks`	`webhooks.write`
One webhook subscription	`GET /v1/webhooks/{webhookId}`	`webhooks.read`
Unsubscribe. Idempotent — deleting an unknown subscription still succeeds	`DELETE /v1/webhooks/{webhookId}`	`webhooks.write`
Rotate the signing secret. The old one keeps verifying for 48 hours so you can deploy without dropping payloads	`POST /v1/webhooks/{webhookId}/rotate-secret`	`webhooks.write`
Delivery history for a subscription, with a failure reason you can act on. Never a response body	`GET /v1/webhooks/{webhookId}/deliveries`	`webhooks.read`
Replay a failed delivery. Without this, an hour of downtime means those events are gone for good	`POST /v1/webhooks/{webhookId}/deliveries/{deliveryId}/retry`	`webhooks.write`

See Authentication before your first call. For write retries, see Writing safely.