FileForms
Webhook deliveries

List Webhook Deliveries

GET
/webhook-deliveries

List webhook deliveries across all of your endpoints, newest first. A delivery is one event sent to one endpoint — an event fanned out to multiple subscribed endpoints appears once per endpoint, each with its own id. Filter by endpoint, event type, created from/to range, or delivery status: delivered (the endpoint acknowledged with a 2xx), pending (automatic retries remain), or failed (retries exhausted). Filters accept multiple comma-separated values, matching any of them. Paginate by passing nextCursor from the previous page as cursor — cursors are opaque; pass them back verbatim, and restart from the first page whenever you change any other parameter. To resume a sync without a stored cursor, pass your last-processed delivery's createdAt as from with order=asc and skip ids you have already seen.

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

endpoint?string

Only deliveries to these webhook endpoints (comma-separated)

status?string

Filter by delivery status (comma-separated for any-of)

type?string

Filter by event type (comma-separated for any-of)

from?|

Only deliveries created at or after this time (ISO 8601)

Formatdate-time
to?|

Only deliveries created at or before this time (ISO 8601)

Formatdate-time
order?string

Sort by creation time

Default"desc"

Value in

  • "asc"
  • "desc"
limit?integer

Page size (1-100)

Range1 <= value <= 100
Default10
cursor?string

Opaque pagination cursor; pass nextCursor from the previous page back verbatim

Length1 <= length

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/webhook-deliveries"
{  "deliveries": [    {      "id": "string",      "endpoint": {        "id": "string",        "url": "string"      },      "type": "document.uploaded",      "status": "delivered",      "attempts": 0,      "deliveredAt": "2019-08-24T14:15:22Z",      "nextAttemptAt": "2019-08-24T14:15:22Z",      "lastAttemptAt": "2019-08-24T14:15:22Z",      "responseStatus": 0,      "responseError": "string",      "data": null,      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}

Get User GET

Retrieve a user.

Resend Webhook Deliveries POST

Make one immediate delivery attempt for each of 1-100 events, returning a per-item outcome (unknown ids report as failed items rather than failing the batch). Resends deliver the SAME events — same `id` and payload, with fresh signature timestamps — so consumers must deduplicate on the event `id`. Works for any event, including already-delivered ones; automatic retries are not restarted or consumed. To retry every failed delivery of an endpoint instead, use Retry Failed Deliveries.