Returns a paginated log of past outbound webhook delivery attempts for your client, newest first. Each entry records the delivered event, the attempt number, whether the endpoint acknowledged it, and the HTTP response status or error message for failed deliveries. Use it to audit and debug your webhook endpoint's reception of events.

Authentication & access

• Requires a client API token: Authorization: Bearer <token>.
• The caller must hold the webhooks.deliveries.read permission and have the OWNER, DEVELOPER, or OPERATIONS role.

Pagination

Both parameters are optional query parameters.

Results are scoped to your client and ordered by attempt time, most recent first.

Response

200 with a WebhookDeliveryListResponse:

• deliveries — array of delivery attempts. Each entry contains:
  • delivery_id — unique ID of this delivery attempt.
  • event_id — ID of the webhook event that was delivered.
  • event_type — event type of the delivered event.
  • attempt_no — delivery attempt number (1 = first attempt).
  • success — whether the endpoint acknowledged the delivery successfully.
  • response_status — HTTP status code returned by your endpoint (may be null).
  • error_message — error description if the delivery failed (may be null).
  • response_body_preview — truncated preview of the response body returned by your endpoint (may be null).
  • created_at — timestamp of this delivery attempt.
• total — total number of delivery attempts matching the query, for pagination.

Error responses

Standard 401 (authentication), 403 (insufficient permission or role), and 429 (rate limit) responses apply to every endpoint and are documented in the Error reference.