Add guests to an existing booking
Add one or more guests to an existing booking. Maximum 10 guests per request, with a limit of 30 total guests per booking.
Rate Limiting: This endpoint is rate limited to 5 requests per minute to prevent abuse.
Seated Events:
This endpoint does not support seated event bookings. For seated events, each guest must be added by creating a new booking for the same event type and time slot via POST /v2/bookings. Attempting to add guests to a seated event booking will return a 400 error.
Email Notifications: When guests are added, the following notifications are sent (unless disabled by event type settings):
-
Organizer & Team Members: Receive an “Add Guests” notification email informing them that new guests have been added to the booking.
-
New Guests: Receive a “Scheduled Event” email with full booking details and calendar invite. If they have a phone number, they also receive an SMS notification.
-
Existing Guests: Receive an “Add Guests” notification email informing them that additional guests have been added to the booking.
If accessed using an OAuth access token, the BOOKING_WRITE scope is required.
Headers
Must be set to 2024-08-13. This header is required as this endpoint does not exist in older API versions.
value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token
Path Parameters
Body
Array of guests to add to the booking. Maximum 100 guests per request.
Response
success, error "success"
Booking data, which can be either a BookingOutput object, a RecurringBookingOutput object, or an array of RecurringBookingOutput objects
- Option 1 · object
- Option 2 · object
- Option 3 · object[]
- Option 4 · object
- Option 5 · object
- Option 6 · object[]