# 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.

Source: https://tamr.link/docs/webhooks/booking-made

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

booking.made:

```json
{
  "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).

booking.made:

```json
{
  "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.

booking.made:

```json
{
  "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_`.

booking.made, test:

```json
{
  "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
  }
}
```
