SeatBuilderSeatBuilder Docs
Webhooks

Get a webhook endpoint

Returns a single webhook endpoint by `id`. Signing secret is not included; use `/rotate-secret` to mint a fresh one.

GET/api/v1/webhooks/{id}

Path Parameters

idstring

Response Body

curl -X GET "http://localhost:3000/api/v1/webhooks/string"

{
  "id": "wh_2a8f1d",
  "url": "https://api.brooklynmusichall.example/seats-webhook",
  "events": [
    "seat.held",
    "seat.booked",
    "seat.released"
  ],
  "description": "Production order pipeline",
  "enabled": true,
  "createdAt": "2026-09-12T14:22:01.044Z",
  "updatedAt": "2026-09-12T14:22:01.044Z"
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}
{
  "statusCode": 0,
  "message": "string",
  "errors": {
    "property1": [
      "string"
    ],
    "property2": [
      "string"
    ]
  }
}

List webhook deliveries GET

Returns a paginated list of past delivery attempts for an endpoint (last 30 days). Each entry includes the delivery `status`, response code, latency, and any retry history. Page with `?page` and `?limit` (1-100, default 50).

Create a webhook endpoint POST

Registers a webhook endpoint and returns the new `id` and signing `secret`. The secret is shown ONCE — store it server-side to verify the HMAC-SHA256 signature on incoming payloads. Subsequent reads omit the secret; use `/rotate-secret` to mint a new one.