Skip to main content
POST
/
v2
/
bookings
/
{bookingUid}
/
attendees
Add an attendee to a booking
curl --request POST \
  --url https://api.cal.com/v2/bookings/{bookingUid}/attendees \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'cal-api-version: <cal-api-version>' \
  --data '
{
  "name": "John Doe",
  "timeZone": "America/New_York",
  "email": "john.doe@example.com",
  "phoneNumber": "+919876543210",
  "language": "it"
}
'
{
  "status": "success",
  "data": {
    "name": "John Doe",
    "email": "john@example.com",
    "displayEmail": "john@example.com",
    "timeZone": "America/New_York",
    "absent": false,
    "id": 251,
    "bookingId": 313,
    "language": "en",
    "phoneNumber": "+1234567890"
  }
}

Headers

​
cal-api-version
string
required

Must be set to 2024-08-13. This header is required as this endpoint does not exist in older API versions.

​
Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Path Parameters

​
bookingUid
string
required

Body

application/json
​
name
string
required

The name of the attendee.

Example:

"John Doe"

​
timeZone
string
required

The time zone of the attendee.

Example:

"America/New_York"

​
email
string
required

The email of the attendee.

Example:

"john.doe@example.com"

​
phoneNumber
string

The phone number of the attendee in international format.

Example:

"+919876543210"

​
language
enum<string>
default:en

The preferred language of the attendee. Used for booking confirmation.

Available options:
ar,
ca,
de,
es,
eu,
he,
id,
ja,
lv,
pl,
ro,
sr,
th,
vi,
az,
cs,
el,
es-419,
fi,
hr,
it,
km,
nl,
pt,
ru,
sv,
tr,
zh-CN,
bg,
da,
en,
et,
fr,
hu,
iw,
ko,
no,
pt-BR,
sk,
ta,
uk,
zh-TW,
bn
Example:

"it"

Response

201 - application/json
​
status
enum<string>
required
Available options:
success,
error
Example:

"success"

​
data
object
required