The attendees object is associated with a booking and contains information of the attendee of that booking. A single booking may contain more than one attendees.
Attendee Object
| Attribute | Description |
|---|---|
| id | integer The `id` of the attendee, generated automatically |
Email of the attendee | |
| name | string Name of the attendee |
| timeZone | enum TimeZone identifier of the attendee, must be a supported timeZone |
| locale | enum Lowercase abbreviation of the locale, eg. `en`, `fr`, etc. |
| booking | Booking Object The booking object linked to this attendee via the `bookingId`. Please check the Bookings endpoint for details on the Booking Object |
| bookingId | integer The `id` of the booking linked to this attendee. All attendees are linked to a booking/event they are supposed to attend or have attended |
| bookingSeat | BookingSeat Object Contains Booking Seat information in case of Seated events |
| noShow | boolean Whether the attendee was a no-show for the meeting/event |
Example Attendee Object
{
id: 123,
email: "jane.doe@example.com",
name: "Jane Doe",
timeZone: "Asia/Dubai",
locale: "en",
booking: [Booking Object],
bookingId: 343,
bookingSeat: [BookingSeat Object],
noShow: false,
}
The attendees endpoint in Cal.com's API suite allows you to CRUD the data related to who is attending a particular booked event.
Find all attendees
This API call lists all attendees of all the bookings of the user making the call. In case of system-wide Admins, this will return all attendees of all bookings
/attendees
Create a new attendee
This API call is used to add attendees to your existing bookings. The user making the call can only add attendees to their own bookings (where they are the hosts). If the call is made by a system-wide Admin, the attendee can be added to any booking.
/attendees
Find an attendee
This API call is used to fetch a specific attendee identified by their id. This is only returned if the attendee belongs to one of the bookings belonging to the user making the request.
/attendees/{id}
Edit an existing attendee
This API call is used to modify details a specific attendee identified by their id. This is only successful if the attendee belongs to one of the bookings belonging to the user making the request, and the request body contains acceptable data.
/attendees/{id}
Remove an existing attendee
This API call is used to remove an attendee (and unlink them from the parent booking) identified by their id. This is only successful if the attendee belongs to one of the bookings belonging to the user making the request.
/attendees/{id}