booking.made webhook
The booking.made webhook: the AI waiter booked a table in your app's chat, with the branch, date, time and party size.
The waiter booked a table in your app's chat. Sent once per write: the webhook-id is fixed by the booking and the moment it was written, so a retried call that writes nothing new sends nothing. status is requested when the restaurant confirms by hand.
Only bookings the waiter writes in an app conversation. A booking made on the QR menu or the booking page, and changes staff make in the dashboard, send nothing yet. A test key's chat books nothing, so it sends none either: use Send a test event to see the shape. Never the guest's name, phone, email or note.
The data object
| Field | Type | Description |
|---|---|---|
conversationId | string | 1 to 200 characters. |
externalUserId | string or null | 1 to 200 characters. |
bookingId | string | 1 to 200 characters. |
status | string | One of requested, confirmed, cancelled, unknown. An open list: read a value you don't know as unknown. |
branch | string | An address: lower-case letters, digits and dashes. |
date | string | Matches ^\d{4}-\d{2}-\d{2}$. |
time | string | Matches ^(?:[01]\d|2[0-3]):[0-5]\d$. |
partySize | integer | 1 to 500. |
Examples
{
"type": "booking.made",
"timestamp": "2026-11-03T14:10:00.000Z",
"livemode": true,
"data": {
"conversationId": "conv_01",
"externalUserId": "user-88213",
"bookingId": "res_01",
"branch": "achrafieh",
"date": "2026-11-07",
"time": "20:30",
"partySize": 4,
"status": "confirmed"
}
}A location that confirms by hand: a request, and a guest diner (no host user).
{
"type": "booking.made",
"timestamp": "2026-11-03T14:12:00.000Z",
"livemode": false,
"data": {
"conversationId": "conv_01",
"externalUserId": null,
"bookingId": "res_02",
"branch": "achrafieh",
"date": "2026-11-07",
"time": "20:30",
"partySize": 4,
"status": "requested"
}
}A status this version doesn't know reads as unknown.
{
"type": "booking.made",
"timestamp": "2026-11-03T14:13:00.000Z",
"livemode": true,
"data": {
"conversationId": "conv_01",
"externalUserId": "user-88213",
"bookingId": "res_03",
"branch": "achrafieh",
"date": "2026-11-07",
"time": "20:30",
"partySize": 4,
"status": "seated"
}
}A test event
What Send a test event in the dashboard sends: livemode: false, and every id starting test_.
{
"type": "booking.made",
"timestamp": "2026-11-16T12:00:00.000Z",
"livemode": false,
"data": {
"conversationId": "test_conversation",
"externalUserId": "test_user",
"bookingId": "test_booking",
"status": "confirmed",
"branch": "test-branch",
"date": "2026-11-16",
"time": "20:00",
"partySize": 2
}
}