List webhook deliveries

GEThttps://api.mailfully.com/v1/webhooks/{id}/deliveries

List one endpoint's delivery attempts, newest first, with keyset pagination (default limit 50). Ownership is checked first, so a cross-org or missing webhook returns 404. Dashboard only (owner, admin, or member). API keys get 403 insufficient_scope.

Loading code example

Loading code example

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

idstringrequired

The webhook endpoint id (whk_…).

Query Parameters

limitintegerdefault: 50

Maximum rows to return. Default 50, clamped to [1, 100].

Required range: x >= 1, x <= 100

Default: 50

cursorstring

Opaque pagination cursor from a previous response's next_cursor.

Response

application/json

A page of delivery attempts.

dataarray<object>required

data.idstringrequired

Delivery attempt id (a bare ULID, no prefix).

data.event_idstringrequired

The delivered event id (also the webhook-id header value).

data.attemptintegerrequired

1-based attempt number (1–7).

data.status_codeintegerrequired

HTTP status the endpoint returned; null on a connection error or timeout, or when delivery was skipped because the endpoint is failing.

data.next_retry_atstring<date-time>required

Due time of the next attempt; null when delivered or after the schedule is exhausted.

data.created_atstring<date-time>required

has_morebooleanrequired

next_cursorstringrequired