List webhook delivery attempts

Every attempt to push an event to your endpoints, newest first, kept 30 days: status code, latency, attempt number and the first 2 KB of the response body.

GET/v1/webhooks/deliveries

Query Parameters

Results are paged. When has_more is true, pass next_cursor from the response as cursor to fetch the next page.

  • endpoint_idstring

    One endpoint (we_...), or status_callback for the attempts to send messages' own status callbacks.

  • event_idstring

    Every attempt for one event

  • limitinteger

    Default 25. Maximum 100.

  • cursorstring

Responses

  • 200Page of WebhookDelivery

    Deliveries, newest first

  • 401Error

    Missing, malformed, or revoked API key

  • 402Error

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 404Error

    No such endpoint

  • 429Error

    Rate limit or quota exceeded

Response Fields

The body is a page: data (the array), has_more, and next_cursor (null on the last page). Each item in data:

  • idstring
  • objectwebhook_delivery
  • endpoint_idstring
  • event_idstring
  • event_typestring
  • attemptinteger

    1 is the first push; up to 6 with retries

  • okboolean
  • status_codeinteger

    Nullable.

  • errortimeout, unreachable, blocked

    Nullable.

  • latency_msinteger
  • response_bodystring

    First 2 KB of what your endpoint answered Nullable.

  • replayboolean

    Sent by a manual replay

  • created_atstring (date-time)

Errors

Every error has the same JSON shape, and request_id matches the X-Request-Id response header. Errors lists every code and what to do about it.

  • 401

    Missing, malformed, or revoked API key

  • 402

    Billable live calls only: the prepaid credit balance cannot cover the call (insufficient_credits); nothing was done or charged

  • 404

    No such endpoint

  • 429

    Rate limit or quota exceeded