Appointment create | Webhook events

When a contact books an appointment — whether through a booking widget, a manual entry in the calendar, or an automation — HoopAI sends an AppointmentCreate event to all configured webhook endpoints. You can use this event to sync appointments to external calendars, trigger confirmation emails, or update a CRM record in real time.

Payload

Field	Type	Description
`type`	`string`	Always `"AppointmentCreate"`
`locationId`	`string`	Account ID the appointment belongs to
`appointment.id`	`string`	Unique ID of the newly created appointment
`appointment.address`	`string`	Meeting location or URL (e.g., a video conference link)
`appointment.title`	`string`	Display name of the appointment
`appointment.calendarId`	`string`	ID of the calendar this appointment was booked on
`appointment.contactId`	`string`	ID of the contact who booked the appointment
`appointment.groupId`	`string`	ID of the calendar group, if the calendar belongs to one
`appointment.appointmentStatus`	`string`	Current status of the appointment (e.g., `confirmed`, `cancelled`, `showed`, `noshow`)
`appointment.assignedUserId`	`string`	ID of the team member the appointment is assigned to
`appointment.users`	`array`	List of user IDs associated with the appointment
`appointment.notes`	`string`	Internal notes attached to the appointment
`appointment.source`	`string`	How the appointment was created (e.g., `booking_widget`, `manual`)
`appointment.startTime`	`string`	ISO 8601 start date and time of the appointment
`appointment.endTime`	`string`	ISO 8601 end date and time of the appointment
`appointment.dateAdded`	`string`	ISO 8601 timestamp when the appointment record was created
`appointment.dateUpdated`	`string`	ISO 8601 timestamp when the appointment record was last updated

Example payload

{
  "type": "AppointmentCreate",
  "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"
  }
}

Appointment update — fires when an existing appointment’s details change
Appointment delete — fires when an appointment is removed
Calendars API — manage calendars and appointments programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related