# booking.changed webhook

> The booking.changed webhook: the AI waiter moved or cancelled a table booking in your app's chat.

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

The waiter moved or cancelled a booking in your app's chat. The same fields as [`booking.made`](https://tamr.link/docs/webhooks/booking-made), with the booking as it now stands; `status` is `cancelled` for a cancellation. Only changes the waiter writes in an app conversation: changes staff make in the dashboard send nothing yet.

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

Moved to another time.

booking.changed:

```json
{
  "type": "booking.changed",
  "timestamp": "2026-11-03T15:00:00.000Z",
  "livemode": true,
  "data": {
    "conversationId": "conv_01",
    "externalUserId": "user-88213",
    "bookingId": "res_01",
    "branch": "achrafieh",
    "date": "2026-11-07",
    "time": "21:00",
    "partySize": 4,
    "status": "confirmed"
  }
}
```

Cancelled.

booking.changed:

```json
{
  "type": "booking.changed",
  "timestamp": "2026-11-03T15:05: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": "cancelled"
  }
}
```

## A test event

What **Send a test event** in the dashboard sends: `livemode: false`, and every id starting `test_`.

booking.changed, test:

```json
{
  "type": "booking.changed",
  "timestamp": "2026-11-16T12:00:00.000Z",
  "livemode": false,
  "data": {
    "conversationId": "test_conversation",
    "externalUserId": "test_user",
    "bookingId": "test_booking",
    "status": "cancelled",
    "branch": "test-branch",
    "date": "2026-11-16",
    "time": "20:00",
    "partySize": 2
  }
}
```
