Teams / Event Types
Create a phone call
Getting Started
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Bookings
Orgs / Delegation Credentials
Orgs / Memberships
Orgs / Orgs
Orgs / Routing forms
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Event Types
Orgs / Teams / Memberships
Orgs / Teams / Routing forms
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Users / Schedules
Orgs / Users / Bookings
Orgs / Users / OOO
Orgs / Users / Schedules
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence - provided authorization header refers to owner of the booking.
- POSTAutomatically reassign booking to a new host automatically - provided authorization header refers to person who reassigned the booking.
- POSTReassign a booking to a specific user specified by the :userId - provided authorization header refers to person who reassigned the booking.
- POSTConfirm booking that requires a confirmation - provided authorization header refers to owner of the booking.
- POSTDecline booking that requires a confirmation - provided authorization header refers to owner of the booking.
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Organizations/Teams Conferencing
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Teams / Event Types
Create a phone call
POST
/
v2
/
teams
/
{teamId}
/
event-types
/
{eventTypeId}
/
create-phone-call
curl --request POST \
--url https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"yourPhoneNumber": "<string>",
"numberToCall": "<string>",
"calApiKey": "<string>",
"enabled": true,
"templateType": "CUSTOM_TEMPLATE",
"schedulerName": "<string>",
"guestName": "<string>",
"guestEmail": "<string>",
"guestCompany": "<string>",
"beginMessage": "<string>",
"generalPrompt": "<string>"
}'
{
"status": "success",
"data": {
"callId": "<string>",
"agentId": "<string>"
}
}
Headers
value must be Bearer <token>
where <token>
is api key prefixed with cal_
Body
application/json
Your phone number
Number to call
CAL API Key
Enabled status
Template type
Available options:
CHECK_IN_APPOINTMENT
, CUSTOM_TEMPLATE
Scheduler name
Guest name
Guest email
Guest company
Begin message
General prompt
Was this page helpful?
curl --request POST \
--url https://api.cal.com/v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '{
"yourPhoneNumber": "<string>",
"numberToCall": "<string>",
"calApiKey": "<string>",
"enabled": true,
"templateType": "CUSTOM_TEMPLATE",
"schedulerName": "<string>",
"guestName": "<string>",
"guestEmail": "<string>",
"guestCompany": "<string>",
"beginMessage": "<string>",
"generalPrompt": "<string>"
}'
{
"status": "success",
"data": {
"callId": "<string>",
"agentId": "<string>"
}
}