Skip to main content
Connect a Cal.com account to a phone number so your agent can check availability and book, reschedule, or cancel appointments live during a call. Configured per phone number.

​
Connect Cal.com

​
string
required
The phone number in E.164 format, passed in the URL.
​
string
required
Your Cal.com API key.
​
string
required
Your Cal.com username.
​
string
required
The Cal.com event type slug to book into.
One booking calendar per phone number. If Google Calendar is already connected to this number, the request is rejected with 409 booking_provider_conflict and nothing is changed. Disconnect the other calendar first.This is deliberate: with two calendars connected the agent is given both sets of booking tools and consistently uses only one, so appointments land in a calendar nobody is watching - and every part of it reports success.

​
Check / remove

​
Notes

  • The number must belong to your account. A number you do not own returns 404.
  • Only one booking calendar can be connected to a number at a time. Connecting a second returns 409 booking_provider_conflict.
  • Google Calendar connects through an authorisation flow in the dashboard rather than the API, so it has no endpoint of its own. The same one-calendar rule applies to it.
  • For the feature guide, see Cal.com.