Webhooks
List deliveries
The endpoint's delivery log, newest first: every event queued for it in the last 30 days and how it went.
Payloads are left out here; get a delivery for one. A pending delivery with attempts above 0 is waiting for its next try at next_attempt.
Authorization
AuthorizationstringheaderrequiredBearer followed by your API key: Bearer sgk_…. The key also works in an X-Api-Key header. See Authentication.Path parameters
uidstringpathrequiredThe webhook's 8-character id. Not case-sensitive.
Query parameters
limitintegerquerydefault: 50Deliveries per page, 1 to 200.
offsetintegerquerydefault: 0How many to skip.
Response
200 OKA page of deliveries.
dataarray of objectsThe deliveries, without
payload.ShowHide delivery attributes
uidstringThe delivery's id, also sent as
X-Sigil-Delivery. A retry repeats it.event_idstringThe event's id, the body's
id: the same for this event's delivery to each of your endpoints.typestringThe event type.
One of
pact.sent pact.viewed pact.signed pact.declined pact.voided pact.sealed pact.lapsed pingpact_uidstring | nullThe pact the event is about.
null for a ping.statusstringpending is queued or waiting for its next attempt; sent got a 2xx; failed was given up on.One of
pending sent failedattemptsintegerAttempts made so far (7 at most).
last_codeinteger | nullThe HTTP status of the last attempt, or
null when it got no response.last_errorstring | nullWhy the last attempt did not count as delivered: the status and the start of your response body, a timeout, or a connection error.
next_attemptstring (date-time) | nullWhen it will next be tried, while
pending.date_createdstring (date-time)When the event was queued.
date_sentstring (date-time) | nullWhen it was delivered.
totalintegerHow many the endpoint has in all.
limitintegerThe page size used.
offsetintegerThe offset used.
Errors
| Status | When |
|---|---|
| 400 Bad Request | limit or offset out of range. |
| 401 Unauthorized | The API key is missing, wrong or revoked. |
| 403 Forbidden | The account's plan does not include API access (Pro and Business do). |
| 404 Not Found | No webhook with that id belongs to your account. |
Every error body is { "error": "message" }. See Errors.