# booking.note.created

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

An internal note was added to a customer or an appointment (in the calendar app or through the API).

Group: Book-and-Pay. Header `X-App2email-Event: booking.note.created`. 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.contact` | string | yes | The customer. |
| `data.appointment_id` | integer |  | The appointment it was written on. null: a note on the customer alone. |
| `data.booking_reference` | string |  |  |
| `data.body` | string | yes | Up to 4000 characters. |
| `data.author` | string |  | A person's name or e-mail, or API key <name>. |
| `data.author_kind` | string |  | one of: `user`, `api`, `agent`, `system` |
| `data.pinned` | boolean |  |  |
| `data.created` | string |  |  |
| `data.updated` | string |  |  |
| `data.on_this_booking` | boolean |  | Only in GET /bookings/{id}/notes: written on that appointment (false: another note of the same customer). |
| `data.booking` | object |  | The appointment the note is on. null: a note on the customer alone. |
| `data.booking.id` | integer |  |  |
| `data.booking.reference` | string |  |  |
| `data.timestamp` | string |  |  |

## Samples

### on a booking

```json
{
  "id": "evt_Cal3k9m2Lw8Rt5Yp1Zs02",
  "type": "booking.note.created",
  "created": "2026-11-11T01:00:00.000Z",
  "number": "4976659348270",
  "data": {
    "id": 7,
    "contact": "61412345678",
    "appointment_id": 42,
    "booking_reference": "BK-7Q3M2A",
    "body": "Prefers the window seat.",
    "author": "Jane Doe",
    "author_kind": "user",
    "pinned": false,
    "created": "2026-11-11T01:12:09.000Z",
    "updated": "2026-11-11T01:12:09.000Z",
    "booking": {
      "id": 42,
      "reference": "BK-7Q3M2A"
    },
    "timestamp": "2026-11-11T01:00:00.000Z"
  }
}
```

## Caused by

- [Add an internal note to an appointment](https://www.app2email.com/docs/api/calendar/add-booking-note.md): `POST /v1/{number}/bookings/{id}/notes`
- [Add an internal note to a customer](https://www.app2email.com/docs/api/calendar/add-customer-note.md): `POST /v1/{number}/bookings/notes`

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