OAuth providers
Cal.com
Set up Cal.com OAuth for open-source scheduling and appointment management
Overview
Section titled “Overview”Connect your users to Cal.com for open-source scheduling, appointment management, and availability tracking.
| Property | Value |
|---|---|
| Provider ID | cal-com |
| Category | Productivity |
| PKCE | Not supported |
| Token refresh | Automatic |
| Redirect URI | Shown in Developer Portal |
Step 1: Create a Cal.com OAuth Client
Section titled “Step 1: Create a Cal.com OAuth Client”Go to Cal.com OAuth Settings
Navigate to Cal.com Settings > Developer > OAuth and sign in.
Create OAuth Client
Click Create OAuth Client.
Configure the client
Enter the client name, add the Alter callback URL (from the Developer Portal) under Redirect URIs (up to 10), and select at least one scope (e.g. BOOKING_READ, BOOKING_WRITE).
Get credentials
Copy the Client ID and Client Secret.
Step 2: Add to Alter Vault
Section titled “Step 2: Add to Alter Vault”Open the Developer Portal
Go to portal.alterauth.com and navigate to the application.
Add Cal.com provider
Go to OAuth Providers > Add Provider > Cal.com.
Enter credentials
- Client ID: Paste your Cal.com Client ID
- Client Secret: Paste your Cal.com Client Secret
Select scopes
Choose the scopes the application needs.
Save
Click Save. The provider is now active.
Available Scopes
Section titled “Available Scopes”| Scope | Description |
|---|---|
BOOKING_READ | Read access to bookings |
BOOKING_WRITE | Create, update, and cancel bookings |
EVENT_TYPE_READ | Read access to event types |
EVENT_TYPE_WRITE | Create and modify event types |
SCHEDULE_READ | Read access to availability schedules |
SCHEDULE_WRITE | Create and modify availability schedules |
PROFILE_READ | Read access to user profile |
PROFILE_WRITE | Update user profile |
APPS_READ | Read access to installed Cal.com apps |
APPS_WRITE | Install and configure Cal.com apps |
- Scopes use the
RESOURCE_ACTIONformat (e.g.BOOKING_READ,BOOKING_WRITE) — notREAD_BOOKING. - Newly created OAuth clients start in pending status and require admin approval from the Cal.com team before they can be used.
- Cal.com’s standard OAuth (this provider) is a separate flow from Cal.com Platform’s “managed users” system — that variant is not covered by this provider.
- For most scheduling use cases,
BOOKING_READandSCHEDULE_READprovide sufficient access. - See the Cal.com OAuth documentation for more details on the flow, scopes, and available API endpoints.