GET/v1/webhooks/{id}/deliveries

Delivery log of an endpoint

Deliveries newest first with a cursor: the event, the origin (dispatch, replay, test), the attempt count, status, last response code, duration, error, the next attempt and the attempt history with the payload preview.

Scope webhooks.manage

Path parameters

idstringrequired

Query parameters

statusenum

PENDINGSUCCEEDEDFAILEDEXHAUSTED

limitintegermin 1max 200default 50

cursorstringmax length 200

Returns

2 fields of the 200 answer

dataarray of objectsrequired

15 fields

idstringrequired

endpointIdstringrequired

eventIdstringrequired

eventTypeenumrequired

item.createditem.needs_attentionitem.helditem.readyitem.pending_approvalitem.scheduleditem.in_productionitem.handed_to_carrieritem.completeditem.returneditem.not_sentitem.faileditem.cancelleditem.suppressedpostbatch.validatedpostbatch.approvedpostbatch.scheduledpostbatch.completedpostbatch.cancelledimport.completedimport.failedtemplate.publishedpreview.readyqr.scannedand 7 more

originenumrequired

DISPATCHREPLAYTEST

attemptintegerrequired

statusenumrequired

PENDINGSUCCEEDEDFAILEDEXHAUSTED

responseCodeinteger or nullrequired

durationMsinteger or nullrequired

errorstring or nullrequired

nextAttemptAtdate-time or nullrequired

deliveredAtdate-time or nullrequired

attemptsarray of objectsrequired

6 fields

attemptintegerrequired

atdate-timerequired

statusenumrequired

SUCCEEDEDFAILED

responseCodeinteger or nullrequired

durationMsintegerrequired

errorstring or nullrequired

payloadobjectrequired

7 fields

idstringrequired

typeenumrequired

versionintegerrequired

createdAtdate-timerequired

organisationIdstringrequired

isTestbooleanrequired

dataobjectrequired

createdAtdate-timerequired

nextCursorstring or nullrequired

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

404Not found

422Validation failed

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

import { PostBuddyClient } from '@postbuddy/sdk'; const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! }); const result = await client.webhooks.deliveries('wh_01J9Y2K8QF4T6W8Z0B2D4F6H8K', { query: { limit: 20, }, });

{ "data": [ { "id": "whd_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "endpointId": "wh_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "eventId": "evt_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "eventType": "item.created", "origin": "DISPATCH", "attempt": 1, "status": "PENDING", "responseCode": 1, "durationMs": 1, "error": "Example", "nextAttemptAt": "2026-10-16T09:14:02.000Z", "deliveredAt": "2026-10-16T09:14:02.000Z", "attempts": [ { "attempt": 1, "at": "2026-10-16T09:14:02.000Z", "status": "SUCCEEDED", "responseCode": 1, "durationMs": 1, "error": "Example" } ], "payload": { "id": "obj_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "type": "item.created", "version": 1, "createdAt": "2026-10-16T09:14:02.000Z", "organisationId": "org_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "isTest": false, "data": {} }, "createdAt": "2026-10-16T09:14:02.000Z" } ], "nextCursor": "Example" }

{ "type": "https://docs.postbuddy.nl/errors/validation_failed", "title": "Validation failed", "status": 422, "code": "validation_failed", "detail": "Validation failed", "requestId": "req_01J9Y2K8QF4T6W8Z0B2D4F6H8K", "errors": [ { "field": "recipient.postalCode", "code": "invalid_string", "message": "Invalid postal code" } ] }