Getting Started
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
- GETGet all attribute options
- POSTCreate an attribute option
- DELDelete an attribute option
- PATCHUpdate an attribute option
- GETGet all assigned attribute options by attribute ID
- GETGet all assigned attribute options by attribute slug
- GETGet all attribute options for a user
- POSTAssign an attribute to a user
- DELUnassign an attribute from a user
Orgs / Bookings
Orgs / Delegation Credentials
Orgs / Memberships
Orgs / Roles
Orgs / Roles / Permissions
Orgs / Routing forms
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Conferencing
- POSTConnect your conferencing application to a team
- GETGet OAuth conferencing app's auth URL for a team
- GETList team conferencing applications
- POSTSet team default conferencing application
- GETGet team default conferencing application
- DELDisconnect team conferencing application
- GETSave conferencing app OAuth credentials
Orgs / Teams / Event Types
Orgs / Teams / Event Types / Private Links
Orgs / Teams / Invite
Orgs / Teams / Memberships
Orgs / Teams / Roles
Orgs / Teams / Roles / Permissions
Orgs / Teams / Routing forms
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Schedules
Orgs / Teams / Stripe
Orgs / Teams / Users / Schedules
Orgs / Teams / Workflows
- GETGet organization team workflows
- POSTCreate organization team workflow for event-types
- GETGet organization team workflows
- POSTCreate organization team workflow for routing-forms
- GETGet organization team workflow
- DELDelete organization team workflow
- PATCHUpdate organization team workflow
- GETGet organization team workflow
- DELDelete organization team routing-form workflow
- PATCHUpdate organization routing form team workflow
Orgs / Users / Bookings
Orgs / Users / OOO
Orgs / Users / Schedules
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- GETGet all the recordings for the booking
- GETGet Cal Video real time transcript download links for the booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTReassign a booking to auto-selected host
- POSTReassign a booking to a specific host
- POSTConfirm a booking
- POSTDecline a booking
- GETGet 'Add to Calendar' links for a booking
- GETGet booking references
- GETGet Video Meeting Sessions. Only supported for Cal Video
Bookings / Guests
Cal Unified Calendars
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
Event Types Private Links
Managed Orgs
OAuth Clients
Organization Team Verified Resources
- POSTRequest email verification code
- POSTRequest phone number verification code
- POSTVerify an email for an org team
- POSTVerify a phone number for an org team
- GETGet list of verified emails of an org team
- GETGet list of verified phone numbers of an org team
- GETGet verified email of an org team by id
- GETGet verified phone number of an org team by id
Routing forms
Schedules
Selected Calendars
Slots
Teams / Event Types
Teams / Memberships
Teams / Schedules
Teams Verified Resources
- POSTRequest email verification code
- POSTRequest phone number verification code
- POSTVerify an email for a team
- POSTVerify a phone number for an org team
- GETGet list of verified emails of a team
- GETGet list of verified phone numbers of a team
- GETGet verified email of a team by id
- GETGet verified phone number of a team by id
Verified Resources
Get default schedule
Copy
Ask AI
curl --request GET \
--url https://api.cal.com/v2/schedules/default \
--header 'Authorization: <authorization>' \
--header 'cal-api-version: <cal-api-version>'Copy
Ask AI
{
"status": "success",
"data": {
"id": 254,
"ownerId": 478,
"name": "Catch up hours",
"timeZone": "Europe/Rome",
"availability": [
{
"days": [
"Monday",
"Tuesday"
],
"startTime": "17:00",
"endTime": "19:00"
},
{
"days": [
"Wednesday",
"Thursday"
],
"startTime": "16:00",
"endTime": "20:00"
}
],
"isDefault": true,
"overrides": [
{
"date": "2024-05-20",
"startTime": "18:00",
"endTime": "21:00"
}
]
}
}Schedules
Get default schedule
Get the default schedule of the authenticated user.
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
GET
/
v2
/
schedules
/
default
Get default schedule
Copy
Ask AI
curl --request GET \
--url https://api.cal.com/v2/schedules/default \
--header 'Authorization: <authorization>' \
--header 'cal-api-version: <cal-api-version>'Copy
Ask AI
{
"status": "success",
"data": {
"id": 254,
"ownerId": 478,
"name": "Catch up hours",
"timeZone": "Europe/Rome",
"availability": [
{
"days": [
"Monday",
"Tuesday"
],
"startTime": "17:00",
"endTime": "19:00"
},
{
"days": [
"Wednesday",
"Thursday"
],
"startTime": "16:00",
"endTime": "20:00"
}
],
"isDefault": true,
"overrides": [
{
"date": "2024-05-20",
"startTime": "18:00",
"endTime": "21:00"
}
]
}
}Headers
value must be Bearer <token> where <token> is api key prefixed with cal_ or managed user access token
Must be set to 2024-06-11. If not set to this value, the endpoint will default to an older version.
Response
200 - application/json
Available options:
success, error Example:
"success"
Show child attributes
Show child attributes
Example:
254
Example:
478
Example:
"Catch up hours"
Example:
"Europe/Rome"
Show child attributes
Show child attributes
Array of days when schedule is active.
Available options:
Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday Example:
["Monday", "Tuesday"]startTime must be a valid time in format HH:MM e.g. 08:00
Example:
"08:00"
endTime must be a valid time in format HH:MM e.g. 15:00
Example:
"15:00"
Example:
[
{
"days": ["Monday", "Tuesday"],
"startTime": "17:00",
"endTime": "19:00"
},
{
"days": ["Wednesday", "Thursday"],
"startTime": "16:00",
"endTime": "20:00"
}
]Example:
true
Example:
[
{
"date": "2024-05-20",
"startTime": "18:00",
"endTime": "21:00"
}
]Was this page helpful?
⌘I