Developers

Webhooks

1 min read

Set up webhooks to deliver reservation and request events to your system in real time.

To register a webhook endpoint, open the sidebar, click Settings, then Developers, then Webhooks.

  1. Click +.
  2. Enter your endpoint URL.
  3. Choose events and venues.
  4. Click Save.

Delivery format

Webhook deliveries are sent as POST requests with JSON like this:

{
  "id": "kn23knx9023nkl",
  "type": "ADMISSION_GROUP_CREATED",
  "created": "2025-05-22T13:45:30.123Z",
  "payload": {}
}
  • id: unique webhook delivery id
  • type: event type
  • created: ISO 8601 timestamp
  • payload: event-specific object

Common event types

  • ADMISSION_GROUP_CREATED
  • ADMISSION_GROUP_UPDATED
  • RESERVATION_REQUEST_CREATED

Admission group payload example

{
  "id": "507f1f77bcf86cd799439011",
  "organization": "507f191e810c19729de860ea",
  "venue": "507f191e810c19729de860eb",
  "type": "TABLE",
  "status": "CONFIRMED",
  "receipts": [{ "subtotal": 100, "tax": 8, "tip": 20, "total": 128 }],
  "posTickets": [{ "subtotal": 50, "tax": 4, "tip": 10, "total": 64 }]
}

Fields vary by event type and venue setup. Your integration should validate payloads defensively.

Related