Delegation Credential

Documentation Index

Fetch the complete documentation index at: https://cal.com/help/llms.txt

Use this file to discover all available pages before exploring further.

Delegation Credential allows organization admins to connect Google Workspace or Microsoft 365 for all members at once. Instead of each member individually authorizing calendar access, the admin sets up a single credential that acts on behalf of every user whose email matches the configured domain.

---

​

Why use Delegation Credential

Without Delegation Credential, every organization member must manually connect their calendar through OAuth. This creates friction during onboarding and means members who haven’t completed setup won’t have calendar integration. With Delegation Credential:

• Calendars are auto-connected for all members whose email matches the configured domain (Google Calendar for Google Workspace, Outlook Calendar for Microsoft 365)
• No individual authorization required — members don’t need to go through OAuth
• New members get instant calendar access as soon as they’re added to the organization
• Admins maintain central control over the calendar integration

---

​

How it works

1. An organization admin creates a Delegation Credential by providing service account credentials for Google Workspace, or by registering an app for Microsoft 365
2. The admin authorizes the credential in the Google Workspace Admin Console or the Microsoft Entra admin center
3. Once enabled, Cal.com uses the credential to access calendars on behalf of all organization members whose email matches the configured domain
4. Members’ availability is automatically checked and new booking events are created in their calendars

---

​

Who can manage Delegation Credentials

• Creating a Delegation Credential — organization owners and admins only
• Enabling a Delegation Credential — organization owners and admins only, and the admin’s email must belong to the configured domain
• Members cannot disconnect a delegation-managed calendar credential, but they can still connect additional calendars manually

---

​

What changes for members

Once a Delegation Credential is enabled:

• The matching calendar is automatically installed — members see it as connected without any action on their part. For Google Workspace this is Google Calendar; for Microsoft 365 this is Outlook Calendar.
• Members can select which calendars to check for conflicts during onboarding
• Google Meet is also available as a booking location automatically when using Google Workspace
• Members cannot disconnect the delegation-managed credential

---

​

Getting started

Follow the setup guide:

---

​

Disabling a Delegation Credential

Disabling a Delegation Credential:

• Immediately stops auto-connecting calendars for members who haven’t manually connected their calendar
• Preserves existing calendar preferences (selected calendars and destination calendar)
• Background jobs clean up delegation-specific records over time

Members who need calendar access after disabling will need to connect their calendar manually through the Cal.com app store.

---

​

Frequently asked questions