Webhook deliveries

Inspect delivery attempts and failures for debugging and monitoring.

The webhook delivery model

Deliveries are stored with a delivery id, an event name, and retry metadata. Payload bodies are not exposed by this endpoint.

Properties

  • Name
    id
    Type
    integer
    Description
    Unique identifier for this delivery record.
  • Name
    delivery_id
    Type
    string
    Description
    Stable identifier for webhook delivery attempts.
  • Name
    event
    Type
    string
    Description
    Event name for the delivery.
  • Name
    status
    Type
    string
    Description
    Delivery status (pending, sent, failed).

GET/v1/webhook-deliveries/

List webhook deliveries

List webhook delivery records. Filter by endpoint_id, status, and pagination params.

Required scope

webhooks:manage

Request

GET
/v1/webhook-deliveries/
curl -G https://api.twentybaan.com/v1/webhook-deliveries/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d endpoint_id=123 \
  -d limit=10

Response

{
  "ok": true,
  "items": [
    {
      "id": 456,
      "endpoint_id": 123,
      "delivery_id": "whd_01J0Y7...",
      "event": "listing.published",
      "attempts": 0,
      "next_attempt_at": 1768212000,
      "status": "pending",
      "last_http_status": null,
      "last_error": null,
      "created_at": 1768212000,
      "created_at_iso": "2026-01-12T08:00:00Z",
      "sent_at": null,
      "sent_at_iso": null
    }
  ],
  "next_before_id": null
}

GET/v1/webhook-deliveries/?id=:id

Retrieve a webhook delivery

Fetch a single delivery record by id.

Required scope

webhooks:manage

Request

GET
/v1/webhook-deliveries/?id=456
curl -G https://api.twentybaan.com/v1/webhook-deliveries/ \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d id=456

Response

{
  "ok": true,
  "delivery": {
    "id": 456,
    "endpoint_id": 123,
    "delivery_id": "whd_01J0Y7...",
    "event": "listing.published",
    "attempts": 0,
    "next_attempt_at": 1768212000,
    "status": "pending",
    "last_http_status": null,
    "last_error": null,
    "created_at": 1768212000,
    "created_at_iso": "2026-01-12T08:00:00Z",
    "sent_at": null,
    "sent_at_iso": null
  }
}
tb twentybaan

Sign in to your account

Not a member? Create an account

Or continue with email

Uncheck on shared devices.