Webhooks

Webhook endpoints are scoped to the organization associated with the API key. Use X-Idempotency-Key on creation, secret rotation, and retry requests when a client may retry after a network failure.

The endpoint secret is returned only when the endpoint is created or its secret is rotated. Store it securely; it is not returned by list or get.

Operations

Method	Path	Purpose
`POST`	`/webhooks`	Create an endpoint
`GET`	`/webhooks`	List endpoints
`GET`	`/webhooks/{webhook_id}`	Retrieve an endpoint
`PATCH`	`/webhooks/{webhook_id}`	Update URL, events, filters, or enabled state
`DELETE`	`/webhooks/{webhook_id}`	Delete an endpoint
`GET`	`/webhooks/{webhook_id}/deliveries`	List delivery attempts
`POST`	`/webhooks/{webhook_id}/deliveries/{delivery_id}/retry`	Retry a failed delivery
`POST`	`/webhooks/{webhook_id}/rotate-secret`	Rotate the signing secret

Delivery records include status, attempt number, response code, timestamps, and the stored event payload when available. Retry is allowed only for failed or exhausted deliveries.

API documentation

Endpoints

Operations

​Operations

Operations