# waitlist.notified

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

A customer on the waitlist was offered a time that opened (WhatsApp, the waitlist template or e-mail).

Group: Book-and-Pay. Header `X-App2email-Event: waitlist.notified`. 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.offer` | object | yes |  |
| `data.offer.slot_id` | string |  |  |
| `data.offer.start` | string |  |  |
| `data.offer.date_label` | string |  |  |
| `data.offer.time_label` | string |  |  |
| `data.offer.channel` | string |  | one of: `whatsapp`, `template`, `email` |
| `data.offer.manual` | boolean |  | true: "Offer now" in the calendar app. |
| `data.timestamp` | string |  |  |

## Samples

### offered

```json
{
  "id": "evt_Wl3k9m2Lw8Rt5Yp1Zs02",
  "type": "waitlist.notified",
  "created": "2026-11-13T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "id": 12,
    "reference": "WL-4HT9XC",
    "status": "notified",
    "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": 1,
    "notified_at": "2026-11-13T01:00:00.000Z",
    "appointment_id": null,
    "note": "Offered Fri 20 Nov 2026 10:30 AM on WhatsApp",
    "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",
    "offer": {
      "slot_id": "2026-11-20T10:30",
      "start": "2026-11-19T23:30:00.000Z",
      "date_label": "Fri 20 Nov 2026",
      "time_label": "10:30 AM",
      "channel": "whatsapp",
      "manual": false
    }
  }
}
```

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