The selected calendar endpoint in Cal.com's API suite allows you to CRUD calendars to check for booking conflicts
Selected Calendar Object
| Attribute | Description |
|---|---|
| user | User Object The user associated with the selected calendar |
| userId | integer The ID of the user associated with the selected calendar |
| integration | string The integration type of the selected calendar |
| externalId | string The external ID of the selected calendar |
| credential | Credential Object The credential associated with the selected calendar |
| credentialId | integer The ID of the credential associated with the selected calendar |
Example Selected Calendar Object
{
"user": [User Object],
"userId": 42,
"integration": "Google Calendar",
"externalId": "google-calendar-987654321",
"credential": [Credential Object],
"credentialId": 101
}
Find all selected calendars
Use this endpoint to list down all the calendars selected to check for conflicts when bookers book you
/selected-calendars
Create a new selected calendar
Use this endpoint to create a new selected calendar to check for conflicts when bookers book you
/selected-calendars
Find a selected calendar
Use this endpoint to get details of a specific calendar selected to check for conflicts when bookers book you. Please use the compound id for identifying the specific calendar ({userId}_{integration}_{externalId})
/selected-calendars/{userId}_{integration}_{externalId}
Edit an existing selected calendar
Use this endpoint to modify details of a specific calendar selected to check for conflicts when bookers book you. Please use the compound id for identifying the specific calendar ({userId}_{integration}_{externalId})
/selected-calendars/{userId}_{integration}_{externalId}
Remove an existing selected calendar
Use this endpoint to remove a specific calendar selected to no longer check for conflicts when bookers book you. Please use the compound id for identifying the specific calendar ({userId}_{integration}_{externalId})
/selected-calendars/{userId}_{integration}_{externalId}