SeatBuilderSeatBuilder Docs
Webhooks

Send a test event to a webhook

Enqueues a synthetic `seat.held` test event for delivery to the endpoint. Returns immediately with a `deliveryId`; check `/deliveries` to see the outcome (success / retrying / dead-lettered).

POST/api/v1/webhooks/{id}/test

Path Parameters

idstring

Response Body

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

{
  "id": "wh_2a8f1d",
  "deliveryId": "wd_4c7e92",
  "status": "queued",
  "queuedAt": "2026-09-22T08:35:00.000Z"
}
{
  "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"
    ]
  }
}

Rotate a webhook signing secret POST

Generates a new HMAC-SHA256 signing secret and returns it ONCE. Update your verification code with the new secret before the next delivery — the old secret is invalidated immediately. Use this after a suspected secret leak or as part of routine rotation.

Replay a webhook delivery POST

Re-enqueues a past delivery for another delivery attempt. Useful when the original delivery failed and the receiver has since been fixed. The payload is identical to the original (same `id`, same body); the receiver should be idempotent on `id`.