First name (either fullname or firstname/lastname required)
lastname
string
No
Last name
fullname
string
No
Full name (alternative to first/last)
phone
string
No
Phone number
receiveReminders
boolean
Yes
Whether the attendee receives reminder emails
notes
object
Yes
Key-value object for form field responses, UTM parameters, and metadata. Keys correspond to form field identifiers on the meeting type. Pass {} if no fields are needed
language
string
No
Locale for notifications (en, de, etc.)
timezone
string
No
Attendee timezone (e.g. Europe/Berlin)
bringalongEmails
string[]
No
Additional attendee emails (max 5)
*Not required when phoneOnlyBooking is true and the meeting type has allowPhoneOnlyBooking enabled. In this case, phone becomes required instead. See Voice AI Bot for details.
For local (in-person at host) channel: selects from the meeting type’s configured locations. For local-attendee channel: can also be provided via attendee.notes.address
skipNotifications
boolean
Skip sending email notifications to the attendee (default: false)
phoneOnlyBooking
boolean
When true, attendee email is not required and phone becomes the identifier. The meeting type must have allowPhoneOnlyBooking enabled. See Voice AI Bot
icsTitle
string
Custom calendar invite title (max 200 chars). Overrides the meeting type’s configured ICS title for this booking
icsDescription
string
Custom calendar invite description (max 2000 chars). Overrides the meeting type’s configured ICS description for this booking
Use icsTitle and icsDescription to override the calendar invite content for a specific booking. If not provided, the meeting type’s configured title and description are used.This is useful for chatbot or AI assistant integrations where you have conversation context to include in the invite.
{ "meetingTypeId": "770e8400-e29b-41d4-a716-446655440002", "start": "2024-01-15T09:00:00+01:00", "hostIds": ["550e8400-e29b-41d4-a716-446655440000"], "icsTitle": "Product Demo — Jane Smith", "icsDescription": "Chat summary: Customer asked about enterprise pricing and SSO. Wants to discuss data residency requirements for EU deployment.", "attendee": { "email": "client@example.com", "firstname": "Jane", "lastname": "Smith", "receiveReminders": true, "notes": {} }}
