# waitlist.removed

HTML: https://www.app2email.com/docs/api/webhooks/waitlist.removed · Index: https://www.app2email.com/docs/api/llms.txt

A customer was taken off the waitlist (by themselves, the business or the API).

Group: Book-and-Pay. Header `X-App2email-Event: waitlist.removed`. 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 |  |  |
| `data.reference` | string | yes | The entry's code. The customer confirms a public-link entry by sending "Join waitlist WL-XXXXXX" on WhatsApp, and leaves with "Leave waitlist WL-XXXXXX". |
| `data.status` | string | yes | pending_confirm: joined on the public booking page, not confirmed on WhatsApp yet. waiting. notified: offered a time that opened (up to 3 offers). booked: the customer booked that service that day. expired: the day passed. removed.; one of: `pending_confirm`, `waiting`, `notified`, `booked`, `expired`, `removed` |
| `data.service_id` | string |  |  |
| `data.service_name` | string |  |  |
| `data.provider_id` | string |  | '' = anyone. |
| `data.provider_name` | string |  |  |
| `data.date` | string |  | The wanted day, YYYY-MM-DD in the business time zone. |
| `data.date_label` | string |  |  |
| `data.slot_id` | string |  | '' = any time that day; else the full group time yyyy-MM-ddTHH:mm. |
| `data.time_label` | string |  |  |
| `data.contact` | string |  |  |
| `data.contact_name` | string |  |  |
| `data.contact_email` | string |  |  |
| `data.seats` | integer |  |  |
| `data.source` | string |  | one of: `web`, `calendar`, `api` |
| `data.notified_count` | integer |  |  |
| `data.notified_at` | string |  |  |
| `data.appointment_id` | integer |  | The booking, once booked. |
| `data.note` | string |  | What the last offer did, in plain words. |
| `data.created` | string |  |  |
| `data.updated` | string |  |  |
| `data.day` | string |  | The same as date. |
| `data.slot_local` | string |  | The same as slot_id. |
| `data.contact_masked` | string |  | The contact with all but the last 4 digits hidden. |
| `data.created_at` | string |  | The same as created. |
| `data.by` | string |  |  |
| `data.timestamp` | string |  |  |

## Samples

### by customer

```json
{
  "id": "evt_Wl3k9m2Lw8Rt5Yp1Zs03",
  "type": "waitlist.removed",
  "created": "2026-11-13T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "id": 12,
    "reference": "WL-4HT9XC",
    "status": "removed",
    "service_id": "haircut",
    "service_name": "Haircut",
    "provider_id": "maria",
    "provider_name": "Maria",
    "date": "2026-11-20",
    "date_label": "Fri 20 Nov 2026",
    "slot_id": "",
    "time_label": "",
    "contact": "61412345678",
    "contact_name": "Jane",
    "contact_email": "",
    "seats": 1,
    "source": "web",
    "notified_count": 0,
    "notified_at": null,
    "appointment_id": null,
    "note": "",
    "created": "2026-11-13T01:00:00.000Z",
    "updated": "2026-11-13T01:00:00.000Z",
    "day": "2026-11-20",
    "slot_local": "",
    "contact_masked": "•••• 5678",
    "created_at": "2026-11-13T01:00:00.000Z",
    "timestamp": "2026-11-13T01:00:00.000Z",
    "by": "customer"
  }
}
```

## Caused by

- [Delete a contact record](https://www.app2email.com/docs/api/contacts/delete-contact.md): `DELETE /v1/{number}/contacts/{identity}`
- [Put a customer on the waitlist of a full day](https://www.app2email.com/docs/api/book-and-pay/add-to-booking-waitlist.md): `POST /v1/{number}/bookings/waitlist`
- [Take a customer off the waitlist](https://www.app2email.com/docs/api/book-and-pay/remove-from-booking-waitlist.md): `POST /v1/{number}/bookings/waitlist/{reference}/remove`
- [Book an appointment for a customer at a free slot](https://www.app2email.com/docs/api/book-and-pay/create-booking.md): `POST /v1/{number}/bookings`
- [Cancel an appointment](https://www.app2email.com/docs/api/book-and-pay/cancel-booking.md): `POST /v1/{number}/bookings/{id}/cancel`

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