> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Appointment delete | Webhook events

> Fires whenever an appointment is permanently removed from an account.

When an appointment is deleted from a calendar — whether by a staff member, an automation, or a contact cancelling through a booking page — HoopAI sends an `AppointmentDelete` event to all configured webhook endpoints. Use this event to cancel corresponding entries in external systems, release reserved resources, or log the removal for auditing purposes.

## Payload

| Field                           | Type     | Description                                                                        |
| ------------------------------- | -------- | ---------------------------------------------------------------------------------- |
| `type`                          | `string` | Always `"AppointmentDelete"`                                                       |
| `locationId`                    | `string` | Account ID the appointment belonged to                                             |
| `appointment.id`                | `string` | Unique ID of the deleted appointment                                               |
| `appointment.address`           | `string` | Meeting location or URL that was associated with the appointment                   |
| `appointment.title`             | `string` | Display name of the appointment at the time of deletion                            |
| `appointment.calendarId`        | `string` | ID of the calendar the appointment was booked on                                   |
| `appointment.contactId`         | `string` | ID of the contact associated with the appointment                                  |
| `appointment.groupId`           | `string` | ID of the calendar group, if the calendar belonged to one                          |
| `appointment.appointmentStatus` | `string` | Status of the appointment at the time of deletion (e.g., `confirmed`, `cancelled`) |
| `appointment.assignedUserId`    | `string` | ID of the team member the appointment was assigned to                              |
| `appointment.users`             | `array`  | List of user IDs that were associated with the appointment                         |
| `appointment.notes`             | `string` | Internal notes that were attached to the appointment                               |
| `appointment.source`            | `string` | How the appointment was originally created (e.g., `booking_widget`, `manual`)      |
| `appointment.startTime`         | `string` | ISO 8601 start date and time of the deleted appointment                            |
| `appointment.endTime`           | `string` | ISO 8601 end date and time of the deleted appointment                              |
| `appointment.dateAdded`         | `string` | ISO 8601 timestamp when the appointment record was originally created              |
| `appointment.dateUpdated`       | `string` | ISO 8601 timestamp when the appointment was last updated before deletion           |

## Example payload

```json theme={null}
{
  "type": "AppointmentDelete",
  "locationId": "0007BWpSzSwfiuSl0tR2",
  "appointment": {
    "id": "0007BWpSzSwfiuSl0tR2",
    "address": "https://example.com/meeting",
    "title": "Appointment with Hoop Dev team",
    "calendarId": "BqTwX8QFwXzpegMve9EQ",
    "contactId": "9NkT25Vor1v4aQatFsv2",
    "groupId": "9NkT25Vor1v4aQatFsv2",
    "appointmentStatus": "confirmed",
    "assignedUserId": "YlWd2wuCAZQzh2cH1fVZ",
    "users": ["YlWd2wuCAZQzh2cH1fVZ", "9NkT25Vor1v4aQatFsv2"],
    "notes": "Some dummy note",
    "source": "booking_widget",
    "startTime": "2023-09-25T16:00:00+05:30",
    "endTime": "2023-09-25T16:00:00+05:30",
    "dateAdded": "2023-09-25T16:00:00+05:30",
    "dateUpdated": "2023-09-25T16:00:00+05:30"
  }
}
```

## Related

* [Appointment create](/api-reference/webhooks/appointment-create) — fires when a new appointment is booked
* [Calendars API](/api-reference/calendars/overview) — manage calendars and appointments programmatically