List an organization webhook's deliveries

List an organization webhook's deliveries

GET/api/v1/organizations/{id}/webhooks/{webhook_id}/deliveries

GET /organizations/{id}/webhooks/{webhook_id}/deliveries
curl -X GET 'https://www.unitpost.com/api/v1/organizations/org_123/webhooks/wh_123/deliveries' \
  -H 'Authorization: Bearer YOUR_ORG_KEY' \
  -H 'User-Agent: my-app/1.0'
Response · 200
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "object": "webhook_delivery",
      "id": "id_123",
      "svix_id": "svix_123",
      "webhook_id": "webhook_123",
      "event_id": "event_123",
      "event_type": "string",
      "status": "pending",
      "attempt": 0,
      "response_status": 0,
      "error": "string",
      "scheduled_at": "2026-01-01T00:00:00.000Z",
      "next_attempt_at": "2026-01-01T00:00:00.000Z",
      "delivered_at": "2026-01-01T00:00:00.000Z",
      "event_created_at": "2026-01-01T00:00:00.000Z",
      "data": {},
      "workspace_id": "workspace_123",
      "external_id": "external_123"
    }
  ]
}

The endpoint's delivery log, newest first and cursor-paginated, as GET /webhooks/{id}/deliveries. Each row also names the event's workspace (workspace_id) and that workspace's external_id now. Narrow it with status, event_type, and one workspace by workspace_id or external_id. A filter value it can't apply (a typo, an unknown id) is ignored and named in the Unitpost-Warning header, and the answer is the one without it; send Unitpost-Strict: true to have it refused instead. A workspace_id or external_id it can't read (malformed, too long, sent twice) is not ignored: the page is empty, named in Unitpost-Warning, never every workspace's deliveries. Each row carries its event's data (message content of every workspace), so this takes organizations:write; a key with only organizations:read gets 403 insufficient_scope. Takes an organization key (ok_live_…) with organizations:write.

Parameters9 fields
FieldTypeDescription
idrequiredstring · pathThe organization's id (`org_…`), from `GET /whoami` or Organization → API.
webhook_idrequiredstring · pathThe organization webhook endpoint's id (`wh_…`).
limitinteger · queryMax rows to return (default 20, max 100).
afterstring · queryReturn rows after this id (forward paging).
beforestring · queryReturn rows before this id (backward paging).
statusstring · queryOne or more delivery statuses, comma-separated: `pending`, `queued`, `retrying`, `succeeded`, `failed`, `exhausted`.
event_typestring · queryOnly deliveries of this event type, e.g. `email.bounced`.
workspace_idstring · queryOnly events of this workspace (`ws_…`).
external_idstring · queryOnly events of the workspace with this `external_id`.
Response · 200 fields17 fields
FieldTypeDescription
objectrequiredenumwebhook_delivery—
idrequiredstringThe delivery id (`msg_…`).
svix_idrequiredstringThe `svix-id` header this delivery's requests carried; retries reuse it, so dedupe on it.
webhook_idrequiredstring—
event_idrequiredstringThe event (`evt_…`). The delivered payload's `event_id` is the same id without the `evt_` prefix.
event_typerequiredstring—
statusrequiredenumpending | queued | retrying | succeeded | failed | exhausted`queued`: held while the endpoint is disabled. `retrying`: an attempt failed and another is scheduled at `next_attempt_at`. `exhausted`: every retry failed.
attemptrequiredintegerAttempts made so far.
response_statusrequiredintegerYour endpoint's last HTTP status, or null before an attempt or on a network error.
errorrequiredstring—
scheduled_atrequiredstring—
next_attempt_atrequiredstring—
delivered_atrequiredstring—
event_created_atrequiredstring—
datarequiredobjectThe event's `data`, as delivered.
workspace_idrequiredstringThe workspace the event happened in (`ws_…`).
external_idrequiredstringThat workspace's `external_id` now (the delivered envelope carried the one at delivery time); null when it has none.
200401403404422429503

Search docs and guides

Search the docs and product guides.