List failed webhook deliveries
GET/webhook.deliveries
List recent failed webhook delivery attempts for the authenticated API client, newest first. Use this to debug a misbehaving endpoint and to find the events you need to replay: successful (2xx) deliveries are never recorded, so every row here is a delivery your endpoint did not accept.
Timeouts are first-class failures: statusCode is 0 and error is
timeout. For HTTP error responses, a truncated copy of your server's
response body is included to aid debugging. The request payload is never
stored โ to recover the data, re-fetch the underlying resource (e.g. via
chat.history) using the delivery's messageId/event context.
Results are strictly scoped to the caller's own subscriptions and retained for roughly 30 days.
Access: Organization and Personal.
Required scope: webhook:read
OpenAPI Spec: webhooks-v1.json
Requestโ
Responsesโ
- 200
- 400
- 401
- 500
Failed delivery attempts for the caller's subscriptions.
Invalid query parameter (e.g. malformed webhook UUID or cursor).
Presented invalid authentication credentials.
An internal error occurred.