List a webhook's deliveries

Lists an endpoint's deliveries, newest first, with the response code, number of attempts and last error. Filter by status (pending, succeeded, failed or dead_letter). Each delivery carries the id of its event.

Requires: desk.admin scope, workspace owner or admin.

Authorization

bearerAuth

AuthorizationBearer <token>

A SautiDesk API key. An owner or admin makes it under Settings in SautiDesk for a named person and picks the scopes. The key is shown once. Send it as Authorization: Bearer <key>. It acts as that person and as nobody else.

In: header

Path Parameters

id*string

The webhook's id (a UUID).

Query Parameters

status?string

pending, succeeded, failed or dead_letter.

cursor?string

next_cursor from the previous page.

limit?integer

Page size, up to 100.

Response

Example

{  "data": [    {      "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",      "endpoint_id": "3c389a9c-ec45-4454-9d6d-d6c94dce61c4",      "event_type": "example",      "event_id": "910fda26-2365-4b38-9285-92086a2a6b3d",      "status": "open",      "attempts": 1,      "response_code": 1,      "last_error": "",      "test": false,      "created_at": "2026-10-14T08:30:00Z",      "delivered_at": "2026-10-14T08:30:00Z",      "next_attempt_at": "2026-10-14T08:30:00Z"    }  ],  "deliveries": [    {      "id": "3f2b8c1e-5a4d-4e7b-9c10-2d6a8e4f1b37",      "endpoint_id": "3c389a9c-ec45-4454-9d6d-d6c94dce61c4",      "event_type": "example",      "event_id": "910fda26-2365-4b38-9285-92086a2a6b3d",      "status": "open",      "attempts": 1,      "response_code": 1,      "last_error": "",      "test": false,      "created_at": "2026-10-14T08:30:00Z",      "delivered_at": "2026-10-14T08:30:00Z",      "next_attempt_at": "2026-10-14T08:30:00Z"    }  ],  "next_cursor": "eyJvIjoyNX0",  "has_more": false}

FieldTypeDescription

datarequiredobject[]

idrequiredstring

endpoint_idrequiredstring

event_typerequiredstring

event_idrequiredstring

statusrequiredstringThe status to set.

attemptsrequiredinteger

response_coderequiredinteger | null

last_errorrequiredstring | null

testrequiredboolean

created_atrequiredstring

delivered_atrequiredstring | null

next_attempt_atrequiredstring

deliveriesrequiredobject[]