Destination Calendars
Update destination calendars
Getting Started
Platform / Cal Provider
Platform / Managed Users
Platform / Webhooks
Orgs / Attributes
Orgs / Attributes / Options
Orgs / Delegation Credentials
Orgs / Event Types
Orgs / Memberships
Orgs / Orgs
Orgs / Schedules
Orgs / Teams
Orgs / Teams / Bookings
Orgs / Teams / Memberships
Orgs / Teams / Routing forms / Responses
Orgs / Teams / Schedules
Orgs / Users / OOO
Orgs / Webhooks
Api Keys
Bookings
- GETGet all bookings
- POSTCreate a booking
- GETGet a booking
- POSTReschedule a booking
- POSTCancel a booking
- POSTMark a booking absence
- POSTAutomatically reassign booking to a new host
- POSTReassign a booking to a specific user
- POSTConfirm booking that requires a confirmation
- POSTDecline booking that requires a confirmation
- GETGet 'Add to Calendar' links for a booking
Calendars
Conferencing
Destination Calendars
Event Types
Event Types / Webhooks
OAuth Clients
Schedules
Selected Calendars
Slots
Stripe
Teams / Event Types
Teams / Memberships
Timezones
Destination Calendars
Update destination calendars
PUT
/
v2
/
destination-calendars
curl --request PUT \
--url https://api.cal.com/v2/destination-calendars \
--header 'Content-Type: application/json' \
--data '{
"integration": "apple_calendar",
"externalId": "https://caldav.icloud.com/26962146906/calendars/1644422A-1945-4438-BBC0-4F0Q23A57R7S/",
"delegationCredentialId": "<string>"
}'
{
"status": "success",
"data": {
"userId": 123,
"integration": "<string>",
"externalId": "<string>",
"credentialId": 123
}
}
Body
application/json
The calendar service you want to integrate, as returned by the /calendars endpoint
Available options:
apple_calendar
, google_calendar
, office365_calendar
Example:
"apple_calendar"
Unique identifier used to represent the specific calendar, as returned by the /calendars endpoint
Example:
"https://caldav.icloud.com/26962146906/calendars/1644422A-1945-4438-BBC0-4F0Q23A57R7S/"
Was this page helpful?
curl --request PUT \
--url https://api.cal.com/v2/destination-calendars \
--header 'Content-Type: application/json' \
--data '{
"integration": "apple_calendar",
"externalId": "https://caldav.icloud.com/26962146906/calendars/1644422A-1945-4438-BBC0-4F0Q23A57R7S/",
"delegationCredentialId": "<string>"
}'
{
"status": "success",
"data": {
"userId": 123,
"integration": "<string>",
"externalId": "<string>",
"credentialId": 123
}
}