# booking.rescheduled

HTML: https://www.app2email.com/docs/api/webhooks/booking.rescheduled · Index: https://www.app2email.com/docs/api/llms.txt

An appointment was moved to another time (the old one is in rescheduled_from).

Group: Book-and-Pay. Header `X-App2email-Event: booking.rescheduled`. Inside the envelope `{id, type, created, number, test?, data}` ([envelope, headers, signature](https://www.app2email.com/docs/api/webhooks.md)). Every webhook of the number gets every number event: filter by `type`.

## data

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `data.id` | integer | yes |  |
| `data.reference` | string | yes | The short code the customer sees. GET /bookings/{id} takes it too. |
| `data.status` | string | yes | one of: `confirmed`, `cancelled`, `completed`, `no_show` |
| `data.contact` | string | yes | The customer's number (digits, country code first) or their business-scoped user id. |
| `data.contact_name` | string |  |  |
| `data.contact_email` | string |  |  |
| `data.service` | object |  |  |
| `data.service.id` | string |  |  |
| `data.service.name` | string |  |  |
| `data.service.duration_min` | integer |  |  |
| `data.start` | string | yes | UTC. |
| `data.end` | string |  | UTC. |
| `data.timezone` | string |  | The business time zone the slot was chosen in. |
| `data.source` | string |  | Booked by the customer in WhatsApp, on the dashboard (or in the calendar app), through this API, or by the customer on the online booking page (web).; one of: `whatsapp_flow`, `dashboard`, `api`, `web` |
| `data.calendar` | object |  |  |
| `data.calendar.provider` | string |  | one of: `builtin`, `google`, `microsoft`, `caldav`, `ics` |
| `data.calendar.event_id` | string |  |  |
| `data.calendar.url` | string |  |  |
| `data.calendar.error` | string |  | The calendar write failed; the booking still stands. |
| `data.answers` | object |  | Every other field the customer filled in the Flow.; any keys |
| `data.notes` | string |  |  |
| `data.provider` | object |  | The staff member, when the business has them. Left out otherwise. |
| `data.provider.id` | string |  |  |
| `data.provider.name` | string |  |  |
| `data.rating` | integer |  | The customer's rating from the follow-up message (5 loved it, 3 OK, 1 not great). Left out until given.; one of: `1`, `3`, `5` |
| `data.payment_status` | string |  | The business's own note on the payment. Left out when none.; one of: `link_sent`, `paid`, `waived` |
| `data.credits_used` | integer |  | Always 0 (memberships were removed on 2026-11-10); kept so existing integrations keep parsing. |
| `data.attendance_confirmed` | string |  | When the customer tapped Confirm on a reminder. |
| `data.cancelled` | object |  | Only when cancelled. |
| `data.cancelled.at` | string |  |  |
| `data.cancelled.by` | string |  | one of: `customer`, `business`, `api`, `system` |
| `data.cancelled.reason` | string |  |  |
| `data.rescheduled_from_id` | integer |  | The appointment this one replaced. |
| `data.link_id` | integer |  | The online booking link (/book/...) it was made through, for correlation. null: none. |
| `data.notes_count` | integer |  | How many internal notes are written on this appointment (GET /bookings/{id}/notes). Given by the calendar routes and the list; left out of webhook events. |
| `data.created` | string |  |  |
| `data.location` | object |  | Where it takes place, as chosen (null: the service has no locations; then config.messages.location). value: the address, the number, the link; a video link made by the connected Google or Microsoft calendar appears here once made. text: how the messages show it. |
| `data.location.kind` | string |  | one of: `in_person`, `phone_we_call`, `phone_you_call`, `video`, `customer_address`, `custom` |
| `data.location.label` | string |  |  |
| `data.location.value` | string |  |  |
| `data.location.text` | string |  |  |
| `data.addons` | object[] |  | The add-ons booked (copied at booking time). |
| `data.addons.id` | string |  |  |
| `data.addons.name` | string |  |  |
| `data.addons.price_amount` | number |  |  |
| `data.addons.duration_min` | integer |  |  |
| `data.guests` | object[] |  | The people who come along. |
| `data.guests.name` | string |  |  |
| `data.guests.phone` | string |  |  |
| `data.answer_items` | object[] |  | The answers to the service's questions as label / value (the raw ones are in answers.q). |
| `data.answer_items.id` | string |  |  |
| `data.answer_items.label` | string |  |  |
| `data.answer_items.value` | string |  |  |
| `data.series` | object |  | This appointment is one of a series (null: not). |
| `data.series.id` | string |  |  |
| `data.series.index` | integer |  |  |
| `data.series.count` | integer |  |  |
| `data.series.freq` | string |  | one of: `weekly`, `biweekly`, `every4weeks`, `monthly` |
| `data.seats` | integer |  | The places this booking takes on a group time (1 + guests); 1 otherwise. |
| `data.rescheduled_from` | object |  | The appointment this one replaced. |
| `data.rescheduled_from.id` | integer |  |  |
| `data.rescheduled_from.reference` | string |  |  |
| `data.rescheduled_from.start` | string |  |  |
| `data.rescheduled_from.end` | string |  |  |
| `data.timestamp` | string |  |  |

## Samples

### moved

```json
{
  "id": "evt_Bk3k9m2Lw8Rt5Yp1Zs03",
  "type": "booking.rescheduled",
  "created": "2026-11-06T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "id": 42,
    "reference": "BK-7Q3M2A",
    "status": "confirmed",
    "contact": "61412345678",
    "contact_name": "Sample Contact",
    "contact_email": "sample@example.com",
    "service": {
      "id": "haircut",
      "name": "Haircut",
      "duration_min": 30
    },
    "start": "2026-11-09T23:00:00.000Z",
    "end": "2026-11-09T23:30:00.000Z",
    "timezone": "Australia/Sydney",
    "source": "whatsapp_flow",
    "calendar": {
      "provider": "google",
      "event_id": "evt_sample_1",
      "url": "https://calendar.google.com/calendar/event?eid=sample"
    },
    "answers": {
      "notes": "Please keep it short"
    },
    "notes": "Please keep it short",
    "provider": {
      "id": "maria",
      "name": "Maria"
    },
    "credits_used": 0,
    "created": "2026-11-06T01:00:00.000Z",
    "timestamp": "2026-11-06T01:00:00.000Z",
    "rescheduled_from_id": 41,
    "rescheduled_from": {
      "id": 41,
      "reference": "BK-2KD8XQ",
      "start": "2026-11-08T23:00:00.000Z",
      "end": "2026-11-08T23:30:00.000Z"
    }
  }
}
```

## Caused by

- [Move an appointment to another time](https://www.app2email.com/docs/api/calendar/reschedule-booking.md): `POST /v1/{number}/bookings/{id}/reschedule`

Send it to your URL: https://www.app2email.com/docs/api/webhooks/tester?type=booking.rescheduled
