Cal integration: operations for AI agents
Cal connects to Type.com as an integration. This page lists the 420 operations documented for Claude and Codex in Type.com: 178 read, 165 write, 77 destructive.
About Cal
Hosted Cal.com API v2 reference for scheduling, bookings, calendars, teams and organizations. Type access depends on the documented endpoint credentials, roles, plans and API-version headers.
Categories: Communication & Meetings
How to connect Cal to Type.com
- Connect
- Bearer API key for hosted api.cal.com/v2; Platform client-secret/OAuth endpoints require separate authorized credentials.
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
420 operations. Your connection's permissions determine which operations are available. API references describe the vendor surface; they do not expand your connection's credentials or access.
420 operations listed.
Orgs / Attributes
- Read
Get all attributes
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes - Read
Get an attribute
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/{attributeId} - Write
Create an attribute
Required membership role: org admin. PBAC permission: organization.attributes.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/attributes - Write
Update an attribute
Required membership role: org admin. PBAC permission: organization.attributes.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/attributes/{attributeId} - Destructive
Delete an attribute
Required membership role: org admin. PBAC permission: organization.attributes.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/attributes/{attributeId}
Orgs / Attributes / Options
- Read
Get all attribute options
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/{attributeId}/options - Read
Get all assigned attribute options by attribute ID
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/{attributeId}/options/assigned - Read
Get all assigned attribute options by attribute slug
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/slugs/{attributeSlug}/options/assigned - Read
Get all attribute options for a user
Required membership role: org member. PBAC permission: organization.attributes.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/options/{userId} - Read
Get attribute assignment history for a user
Required membership role: org admin. PBAC permission: organization.attributes.readAuditLogs. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/attributes/assignments/{userId}/history - Write
Create an attribute option
Required membership role: org admin. PBAC permission: organization.attributes.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/attributes/{attributeId}/options - Write
Update an attribute option
Required membership role: org admin. PBAC permission: organization.attributes.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/attributes/{attributeId}/options/{optionId} - Write
Assign an attribute to a user
Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/attributes/options/{userId} - Write
Update an attribute assignment for a user
Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId} - Destructive
Delete an attribute option
Required membership role: org admin. PBAC permission: organization.attributes.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/attributes/{attributeId}/options/{optionId} - Destructive
Unassign an attribute from a user
Required membership role: org admin. PBAC permission: organization.attributes.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/attributes/options/{userId}/{attributeOptionId}
Orgs / Attributes / Sync History
- Read
Get attribute sync history
Returns a paginated list of integration sync runs for the organization, including rule evaluations, applied field mappings, and team membership changes per run. Supports cursor-based pagination.
GET /v2/organizations/{orgId}/attributes/sync-history - Read
Get sync history for a specific user
Returns a paginated list of integration sync runs filtered by user within the organization, including rule evaluations, applied field mappings, and team membership changes per run. Supports cursor-based pagination.
GET /v2/organizations/{orgId}/attributes/sync-history/user/{userId}
Orgs / Bookings
- Read
Get organization bookings (cursor pagination)
Cursor-paginated org bookings listing. Pass the pagination.nextCursor from the previous response as the cursor query parameter to fetch the next page. Omit cursor to fetch the first page. pagination.hasMore is false and pagination.nextCursor is null when you've reached the last page. Must pass cal-api-version: 2026-05-01 header. status filters to a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses. To list bookings across multiple statuses, issue parallel requests — one per status — and merge client-side. Required membership role: org admin. PBAC permission: booking.readOrgBookings. If accessed using an OAuth access token, the ORGBOOKINGREAD scope is required. For managed organizations, bookings where the managed organization owner is the organizer or an attendee are excluded from the result.
GET /v2/organizations/{orgId}/bookings - Destructive
Report an organization booking
Report a booking within the organization. A booking report is created and the reported booking along with other matching upcoming bookings are silently cancelled. If accessed using an OAuth access token, the ORGBOOKINGWRITE scope is required.
POST /v2/organizations/{orgId}/bookings/report - Destructive
Block an organization booking attendee
Add the email or domain of a booking attendee to the organization blocklist. All matching upcoming bookings in the organization are silently cancelled. If accessed using an OAuth access token, the ORGBOOKINGWRITE scope is required.
POST /v2/organizations/{orgId}/bookings/block
Orgs / Calendar Invites
- Read
Get organization calendar-invite defaults
Returns the host and guest organization defaults used when an event type inherits its calendar-invite description. Access matches the web organization procedure: the organization.update PBAC permission grants access, or the ORGADMIN role applies when PBAC is not granting it. OAuth clients require ORGPROFILEREAD. Custom templates are limited to 5,000 characters. Platform organizations must have the Essentials plan; regular organizations are not subject to platform plan gating. An inherit mode uses Cal.com's standard invite description.
GET /v2/organizations/{orgId}/calendar-invites - Write
Update organization calendar-invite defaults
Updates one or both host and guest organization defaults; omitted audiences are unchanged. Access matches the web organization procedure: the organization.update PBAC permission grants access, or the ORGADMIN role applies when PBAC is not granting it. OAuth clients require ORGPROFILEWRITE. Platform organizations must have the Essentials plan; regular organizations are not subject to platform plan gating. custom templates are limited to 5,000 characters and sanitized before saving; Markdown links are preserved. An inherit mode clears the organization default. Event types resolve their own custom template first, then this default, then Cal.com's standard description.
PATCH /v2/organizations/{orgId}/calendar-invites
Orgs / Delegation Credentials
- Read
Get all delegation credentials of your organization
Optionally filter by domain to look up the delegation credential configured for a specific domain. Required membership role: org admin. PBAC permission: organization.readDelegationCredentials. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/delegation-credentials - Read
Get a delegation credential of your organization
Required membership role: org admin. PBAC permission: organization.readDelegationCredentials. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/delegation-credentials/{credentialId} - Write
Save delegation credentials for your organization
Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/delegation-credentials - Write
Update delegation credentials of your organization
Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/delegation-credentials/{credentialId} - Write
Reset a blocked delegation credential's secret rotation state
Clears the terminal secret-rotation failure state so managed secret rotation resumes normally. Use this after fixing whatever external configuration issues caused rotation to reach a terminal state. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/delegation-credentials/{credentialId}/reset-rotation - Write
Verify a delegation credential's workspace setup
Runs the same Google Workspace / Microsoft 365 check as enabling the credential, impersonating the authenticated user, without changing the credential. Works whether or not the credential is enabled. A failed check is returned as verified: false with the reason, not as an error. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/delegation-credentials/{credentialId}/verify - Destructive
Delete delegation credentials of your organization
Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/delegation-credentials/{credentialId}
Orgs / Memberships
- Read
Get all memberships
Required membership role: org admin. PBAC permission: organization.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/memberships - Read
Get a membership
Required membership role: org admin. PBAC permission: organization.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/memberships/{membershipId} - Write
Create a membership
Required membership role: org admin. PBAC permission: organization.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required. Two identifier modes are accepted in the request body: 1. userId — attach an existing user (by id) directly. Use when the caller already knows the Cal.com user id and just needs the membership row created/updated. No notification email is sent. 2. email — invite an existing Cal.com user (by email). Runs the same invite flow the dashboard uses; the user must already exist (if not, the request returns 404 — create them first via POST /v2/organizations/{orgId}/users). What happens next depends on the organization's settings: - Auto-attach path. When the organization is verified by Cal.com and the invitee's email domain matches the organization's configured auto-accept domain (both set by Cal.com during organization verification — not editable by the organization's own admins), the user is added as an accepted member: their organization profile is created, the membership is created with accepted: true, and they receive a "you've been added to the organization" notification email. - Pending-invite path. If either condition is not met, the user receives an "accept your invite" notification email and the membership is created with accepted: false until they accept it via the dashboard. No organization profile is created until acceptance. Either way the response's accepted value reflects the outcome, seat addition is recorded, and the new seat count is pushed to the billing provider.
POST /v2/organizations/{orgId}/memberships - Write
Update a membership
Required membership role: org admin. PBAC permission: organization.changeMemberRole. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required.
PATCH /v2/organizations/{orgId}/memberships/{membershipId} - Destructive
Delete a membership
Required membership role: org admin. PBAC permission: organization.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required.
DELETE /v2/organizations/{orgId}/memberships/{membershipId}
Orgs / Roles
- Read
Get all organization roles
Required membership role: org admin. PBAC permission: role.readOrgRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/roles - Read
Get a specific organization role
Required membership role: org admin. PBAC permission: role.readOrgRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/roles/{roleId} - Write
Create a new organization role
Required membership role: org admin. PBAC permission: role.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/roles - Write
Update an organization role
Required membership role: org admin. PBAC permission: role.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/roles/{roleId} - Destructive
Delete an organization role
Required membership role: org admin. PBAC permission: role.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/roles/{roleId}
Orgs / Roles / Permissions
- Read
List permissions for an organization role
Required membership role: org admin. PBAC permission: role.readOrgRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/roles/{roleId}/permissions - Write
Add permissions to an organization role (single or batch)
Required membership role: org admin. PBAC permission: role.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/roles/{roleId}/permissions - Destructive
Replace all permissions for an organization role
Required membership role: org admin. PBAC permission: role.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PUT /v2/organizations/{orgId}/roles/{roleId}/permissions - Destructive
Remove multiple permissions from an organization role
Required membership role: org admin. PBAC permission: role.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/roles/{roleId}/permissions - Destructive
Remove a permission from an organization role
Required membership role: org admin. PBAC permission: role.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/roles/{roleId}/permissions/{permission}
Orgs / Routing forms
- Read
Get organization routing forms
Required membership role: org admin. PBAC permission: routingForm.readOrgRoutingForms. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGROUTINGFORMREAD scope is required.
GET /v2/organizations/{orgId}/routing-forms - Read
Get routing form responses
Required membership role: org admin. PBAC permission: routingForm.readResponsePii. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGROUTINGFORMREAD scope is required.
GET /v2/organizations/{orgId}/routing-forms/{routingFormId}/responses - Write
Create routing form response and get available slots
Required membership role: org admin. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGROUTINGFORMWRITE scope is required.
POST /v2/organizations/{orgId}/routing-forms/{routingFormId}/responses - Write
Update routing form response
Required membership role: org admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGROUTINGFORMWRITE scope is required.
PATCH /v2/organizations/{orgId}/routing-forms/{routingFormId}/responses/{responseId}
Orgs / Schedules
- Read
Get all schedules
Required membership role: org admin. PBAC permission: availability.readOrgAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/schedules
Orgs / Secondary Domains
- Read
Get all secondary domains of an organization
For platform, the plan must be 'ESSENTIALS' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/secondary-domains - Read
Get a secondary domain of an organization
For platform, the plan must be 'ESSENTIALS' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/secondary-domains/{domainId} - Write
Add a secondary domain to an organization
Adds an unverified secondary domain. Publish the returned verificationRecord as a DNS TXT record and call the verify endpoint. Once verified, members with this email domain join the organization with usernames suffixed by usernameSuffix (e.g. john@acme.fr becomes john-fr). For platform, the plan must be 'ESSENTIALS' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/secondary-domains - Write
Verify a secondary domain of an organization
Checks the DNS TXT record returned in verificationRecord and marks the domain as verified. For platform, the plan must be 'ESSENTIALS' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/secondary-domains/{domainId}/verify - Destructive
Remove a secondary domain from an organization
For platform, the plan must be 'ESSENTIALS' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/secondary-domains/{domainId}
Orgs / Teams
- Read
Get all teams
Required membership role: org admin. PBAC permission: team.readOrgTeams. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGPROFILEREAD scope is required.
GET /v2/organizations/{orgId}/teams - Read
Get teams membership for user
Required membership role: org member. PBAC permission: team.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/teams/me - Read
Get a team
Required membership role: team admin. PBAC permission: team.readTeamSettings. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMPROFILEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId} - Write
Create a team
Required membership role: org admin. PBAC permission: team.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGPROFILEWRITE scope is required.
POST /v2/organizations/{orgId}/teams - Write
Update a team
Required membership role: org admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGPROFILEWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId} - Destructive
Delete a team
Required membership role: org admin. PBAC permission: team.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGPROFILEWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}
Orgs / Teams / Bookings
- Read
Get organization team bookings
Required membership role: team admin. PBAC permission: booking.readTeamBookings. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMBOOKINGREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/bookings - Read
Get booking references
Required membership role: team admin. PBAC permission: booking.readTeamBookings. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMBOOKINGREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/bookings/{bookingUid}/references
Orgs / Teams / Conferencing
- Read
Get OAuth conferencing app's auth URL for a team
Returns the URL to send a team admin to so they can authorize Zoom or Microsoft Teams for the team. Redirect their browser to it - the provider then returns them to a callback already registered by Cal.com, which stores the credential against the team rather than against the admin who authorized it. To cover every team in the organization with a single handshake, use GET /v2/organizations/{orgId}/conferencing/{app}/oauth/auth-url instead. returnTo and onErrorReturnTo must each be a relative path or an absolute http(s) URL. The returned URL expires 10 minutes after this call, so redirect immediately rather than caching it. Walkthrough: https://cal.com/docs/api-reference/v2/conferencing-apps. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/auth-url - Read
List team conferencing applications
Required membership role: team admin. PBAC permission: team.readConferencing. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/conferencing - Read
Get team default conferencing application
Required membership role: team admin. PBAC permission: team.readConferencing. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/conferencing/default - Read
Get OAuth conferencing app's auth URL for an organization
Returns the URL to send an organization admin to so they can authorize Zoom or Microsoft Teams once for the whole organization. The resulting credential is owned by the organization, so every team and member below it can use the app without its own OAuth handshake. Redirect their browser to it - the provider then returns them to a callback already registered by Cal.com. returnTo and onErrorReturnTo must each be a relative path or an absolute http(s) URL. The returned URL expires 10 minutes after this call, so redirect immediately rather than caching it. Walkthrough: https://cal.com/docs/api-reference/v2/conferencing-apps. Required membership role: org admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
GET /v2/organizations/{orgId}/conferencing/{app}/oauth/auth-url - Read
List organization conferencing applications
Lists the conferencing apps installed on the organization itself, not those installed on its teams or members. Required membership role: org admin. PBAC permission: team.readConferencing. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSREAD scope is required.
GET /v2/organizations/{orgId}/conferencing - Write
Connect your conferencing application to a team
Only google-meet can be connected this way, and only for a team that already has a valid Google Calendar connection. Zoom and Microsoft Teams require an OAuth handshake - start it with GET /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/auth-url instead. Walkthrough: https://cal.com/docs/api-reference/v2/conferencing-apps. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/connect - Write
Set team default conferencing application
Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/default - Write
Save conferencing app OAuth credentials
Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/oauth/callback - Write
Save organization conferencing app OAuth credentials
Required membership role: org admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
GET /v2/organizations/{orgId}/conferencing/{app}/oauth/callback - Destructive
Disconnect team conferencing application
Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/conferencing/{app}/disconnect - Destructive
Disconnect organization conferencing application
Required membership role: org admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMAPPSWRITE scope is required.
DELETE /v2/organizations/{orgId}/conferencing/{app}/disconnect
Orgs / Teams / Event Types / Private Links
- Read
Get all private links for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links - Write
Create a private link for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links - Write
Update a private link for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId} - Destructive
Delete a private link for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/private-links/{linkId}
Orgs / Teams / Invite
- Write
Create team invite link
Required membership role: team admin. PBAC permission: team.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/invite
Orgs / Teams / Memberships
- Read
Get all memberships
Required membership role: team admin. PBAC permission: team.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/memberships - Read
Get a membership
Required membership role: team admin. PBAC permission: team.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId} - Write
Create a membership
Required membership role: team admin. PBAC permission: team.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/memberships - Write
Update a membership
Required membership role: team admin. PBAC permission: team.changeMemberRole. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId} - Destructive
Delete a membership
Required membership role: team admin. PBAC permission: team.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/memberships/{membershipId}
Orgs / Teams / Roles
- Read
Get all organization team roles
Required membership role: org admin. PBAC permission: role.readTeamRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/roles - Read
Get a specific organization team role
Required membership role: org admin. PBAC permission: role.readTeamRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId} - Write
Create a new organization team role
POST /v2/organizations/{orgId}/teams/{teamId}/roles
POST /v2/organizations/{orgId}/teams/{teamId}/roles - Write
Update an organization team role
PATCH /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}
PATCH /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId} - Destructive
Delete an organization team role
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}
Orgs / Teams / Roles / Permissions
- Read
List permissions for an organization team role
Required membership role: org admin. PBAC permission: role.readTeamRoles. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions - Write
Add permissions to an organization team role (single or batch)
POST /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions
POST /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions - Destructive
Replace all permissions for an organization team role
PUT /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions
PUT /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions - Destructive
Remove multiple permissions from an organization team role
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions - Destructive
Remove a permission from an organization team role
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions/{permission}
DELETE /v2/organizations/{orgId}/teams/{teamId}/roles/{roleId}/permissions/{permission}
Orgs / Teams / Routing forms
- Read
Get team routing forms
Required membership role: team admin. PBAC permission: routingForm.readTeamRoutingForms. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/routing-forms - Read
Get team routing form
Required membership role: team admin. PBAC permission: routingForm.readTeamRoutingForms. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId} - Read
Get team routing form history
Required membership role: org member. PBAC permission: routingForm.readTeamAuditLogs on the team or routingForm.readOrgAuditLogs on the organization. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMREAD scope is required. Returns the form's change history, newest first.
GET /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/history - Write
Create team routing form
Required membership role: team admin. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required. The form is created with no questions and a fallback route.
POST /v2/organizations/{orgId}/teams/{teamId}/routing-forms - Write
Edit team routing form routes
Required membership role: team admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required. Previews by default (dryRun defaults to true); send dryRun: false with expectedUpdatedAt to save.
PATCH /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/routes - Write
Edit team routing form fields
Required membership role: team admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required. Previews by default (dryRun defaults to true); send dryRun: false with expectedUpdatedAt to save.
PATCH /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/fields
Orgs / Teams / Routing forms / Responses
- Read
Get organization team routing form responses
Required membership role: team admin. PBAC permission: routingForm.readResponsePii. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses - Write
Create routing form response and get available slots
Required membership role: team member. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses - Write
Update routing form response
Required membership role: team admin. PBAC permission: routingForm.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/routing-forms/{routingFormId}/responses/{responseId}
Orgs / Teams / Schedules
- Read
Get all team member schedules
Required membership role: team admin. PBAC permission: availability.readTeamAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/schedules
Orgs / Teams / Stripe
- Read
Get Stripe connect URL for a team
Required membership role: team admin. PBAC permission: organization.manageBilling. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/stripe/connect - Read
Check team Stripe connection
Required membership role: team admin. PBAC permission: organization.manageBilling. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/stripe/check - Write
Save Stripe credentials
Required membership role: team admin. PBAC permission: organization.manageBilling. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/teams/{teamId}/stripe/save
Orgs / Teams / Users / Schedules
- Read
Get schedules of a team member
Required membership role: team admin. PBAC permission: availability.readTeamAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/users/{userId}/schedules
Orgs / Teams / Workflows
- Read
Get organization team routing form workflows
Required membership role: team admin. PBAC permission: workflow.readTeamWorkflows. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form - Read
Get organization team routing form workflow
Required membership role: team admin. PBAC permission: workflow.readTeamWorkflows. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form - Read
Get organization team workflows
Required membership role: team admin. PBAC permission: workflow.readTeamWorkflows. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/workflows - Read
Get organization team workflow
Required membership role: team admin. PBAC permission: workflow.readTeamWorkflows. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId} - Read
Get organization team workflow condition fields
GET /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/condition-fields
GET /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/condition-fields - Write
Create organization team workflow for routing-forms
Required membership role: team admin. PBAC permission: workflow.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/workflows/routing-form - Write
Update organization routing form team workflow
Required membership role: team admin. PBAC permission: workflow.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form - Write
Create organization team workflow for event-types
Required membership role: team admin. PBAC permission: workflow.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/workflows - Write
Update organization team workflow
Required membership role: team admin. PBAC permission: workflow.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId} - Destructive
Delete organization team routing-form workflow
Required membership role: team admin. PBAC permission: workflow.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}/routing-form - Destructive
Delete organization team workflow
Required membership role: team admin. PBAC permission: workflow.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMWORKFLOWWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/workflows/{workflowId}
Orgs / Users
- Read
Get all users
Required membership role: org admin. PBAC permission: organization.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPREAD scope is required.
GET /v2/organizations/{orgId}/users - Write
Create a user
Required membership role: org admin. PBAC permission: organization.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required. This endpoint creates a brand-new Cal.com user account and attaches them to the organization. If the email already belongs to an existing Cal.com user, the request fails with 409 Conflict. When the user is already a member of this organization the message is A user already exists with that email and is already a member of this organization. When the user exists but is not a member, the message is A user already exists with this email. Use POST /v2/organizations/{orgId}/memberships to add them to this organization.. A common case is re-adding someone who was previously removed from the organization via the dashboard: the membership is gone, but the underlying Cal.com user account still exists. To attach an existing Cal.com user to the organization, use POST /v2/organizations/{orgId}/memberships with the email field instead.
POST /v2/organizations/{orgId}/users - Write
Update a user
Required membership role: org admin. PBAC permission: organization.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required.
PATCH /v2/organizations/{orgId}/users/{userId} - Destructive
Delete a user
Required membership role: org admin. PBAC permission: organization.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGMEMBERSHIPWRITE scope is required.
DELETE /v2/organizations/{orgId}/users/{userId}
Orgs / Users / Bookings
- Read
Get all bookings for an organization user
If accessed using an OAuth access token, the ORGBOOKINGREAD scope is required.
GET /v2/organizations/{orgId}/users/{userId}/bookings
Orgs / Users / Conferencing
- Read
List conferencing apps of an organization user
Lists all connected conferencing apps for a specific user within the organization, including which one is set as default. Required membership role: org admin. PBAC permission: team.readConferencing. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/organizations/{orgId}/users/{userId}/conferencing - Write
Set the default conferencing app for an organization user
Sets the default conferencing app for a specific user within the organization. Required membership role: org admin. PBAC permission: organization.editUsers. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/organizations/{orgId}/users/{userId}/conferencing/default
Orgs / Users / OOO
- Read
Get all out-of-office entries for a user
Required membership role: org admin. PBAC permission: ooo.readOrgOoo. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/users/{userId}/ooo - Read
Get all out-of-office entries for organization users
Required membership role: org admin. PBAC permission: ooo.readOrgOoo. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/ooo - Write
Create an out-of-office entry for a user
If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
POST /v2/organizations/{orgId}/users/{userId}/ooo - Write
Update an out-of-office entry for a user
If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
PATCH /v2/organizations/{orgId}/users/{userId}/ooo/{oooId} - Destructive
Delete an out-of-office entry for a user
If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
DELETE /v2/organizations/{orgId}/users/{userId}/ooo/{oooId}
Orgs / Users / Schedules
- Read
Get all schedules
Required membership role: org admin. PBAC permission: availability.readOrgAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/users/{userId}/schedules - Read
Get a schedule
Required membership role: org admin. PBAC permission: availability.readOrgAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEREAD scope is required.
GET /v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId} - Write
Create a schedule
Required membership role: org admin. PBAC permission: availability.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
POST /v2/organizations/{orgId}/users/{userId}/schedules - Write
Update a schedule
Required membership role: org admin. PBAC permission: availability.updateOrgAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
PATCH /v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId} - Destructive
Delete a schedule
Required membership role: org admin. PBAC permission: availability.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGSCHEDULEWRITE scope is required.
DELETE /v2/organizations/{orgId}/users/{userId}/schedules/{scheduleId}
Orgs / Webhooks
- Read
Get all webhooks
Required membership role: org admin. PBAC permission: webhook.readOrgWebhooks. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGWEBHOOKREAD scope is required.
GET /v2/organizations/{orgId}/webhooks - Read
Get a webhook
Required membership role: org admin. PBAC permission: webhook.readOrgWebhooks. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGWEBHOOKREAD scope is required.
GET /v2/organizations/{orgId}/webhooks/{webhookId} - Write
Create a webhook
Required membership role: org admin. PBAC permission: webhook.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGWEBHOOKWRITE scope is required.
POST /v2/organizations/{orgId}/webhooks - Write
Update a webhook
Required membership role: org admin. PBAC permission: webhook.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGWEBHOOKWRITE scope is required.
PATCH /v2/organizations/{orgId}/webhooks/{webhookId} - Destructive
Delete a webhook
Required membership role: org admin. PBAC permission: webhook.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGWEBHOOKWRITE scope is required.
DELETE /v2/organizations/{orgId}/webhooks/{webhookId}
Allowlists
- Read
Get the Cal.com IP allowlists
Returns the IPv4 ranges Cal.com sends traffic from and receives traffic on, keyed by service. Poll this endpoint instead of hard-coding addresses, because they can change.
GET /v2/allowlists - Read
Get the Cal.com IP allowlist of one service
GET /v2/allowlists/{service}
GET /v2/allowlists/{service}
Api Keys
- Destructive
Refresh API Key
Generate a new API key and delete the current one. Provide API key to refresh as a Bearer token in the Authorization header (e.g. "Authorization: Bearer ").
POST /v2/api-keys/refresh
Bookings
- Read
Get all bookings
Cursor-based pagination. Pass the pagination.nextCursor from the previous response as the cursor query parameter to fetch the next page. Omit cursor to fetch the first page. pagination.hasMore is false and pagination.nextCursor is null when you've reached the last page. Must pass cal-api-version: 2026-05-01 header. status filters to a single status. Pass one (e.g. ?status=upcoming) or omit to walk all statuses. To list bookings across multiple statuses, issue parallel requests — one per status — and merge client-side. The sort direction and the page-1 anchor are derived from status: | status | Sort | Walk direction | Page-1 anchor (uuid bound) | |---|---|---|---| | (omitted) | Booking.uuid DESC | Backward from far-future | upper bound at year 2100 | | upcoming | Booking.uuid ASC | Forward in time | lower bound at NOW() − 1h | | recurring | Booking.uuid ASC | Forward in time | lower bound at NOW() − 1h | | unconfirmed | Booking.uuid ASC | Forward in time | lower bound at NOW() − 1h | | past | Booking.uuid DESC | Backward in time | upper bound at NOW() | | cancelled | Booking.uuid DESC | Backward from far-future | upper bound at year 2100 | If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings - Read
Get a booking by seat UID
Get a seated booking by its seat reference UID. This is useful when you have a seatUid from a seated booking and want to retrieve the full booking details. Cancelled seats remain resolvable by the same seatUid: the parent booking is returned and the matching attendee is tagged with status cancelled. Only that attendee is listed — remaining live attendees are not mixed in. Occupied-seat counts on GET /bookings/:uid are unchanged. A seat reschedule that keeps the same seatUid still resolves from the live row. If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
GET /v2/bookings/by-seat/{seatUid} - Read
Get a booking
:bookingUid can be 1. uid of a normal booking 2. uid of one of the recurring booking recurrences 3. uid of recurring booking which will return an array of all recurring booking recurrences (stored as recurringBookingUid on one of the individual recurrences). If you are fetching a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
GET /v2/bookings/{bookingUid} - Read
Get all the recordings for the booking
Fetches all the recordings for the booking :bookingUid. Requires authentication and proper authorization. Access is granted to the booking organizer and hosts, and to team or organization members whose role can view the booking and has the booking.readRecordings permission, which team and organization admins and owners have by default. Recording download links are valid for 1 hour only. Make a new request to generate fresh links after expiration. cal-api-version: 2026-02-25 is required in the request header. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/recordings - Read
Get Cal Video real time transcript download links for the booking
Fetches all the transcript download links for the booking :bookingUid. Requires authentication and proper authorization. Access is granted to the booking organizer and hosts, and to team or organization members whose role can view the booking and has the booking.readRecordings permission, which team and organization admins and owners have by default. Transcripts are generated when clicking "Transcribe" during a Cal Video meeting. Download links are valid for 1 hour only - make a new request to generate fresh links after expiration. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/transcripts - Read
Get 'Add to Calendar' links for a booking
Retrieve calendar links for a booking that can be used to add the event to various calendar services. Returns links for Google Calendar, Microsoft Office, Microsoft Outlook, and a downloadable ICS file. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/calendar-links - Read
Get booking references
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/references - Read
Get Video Meeting Sessions. Only supported for Cal Video
Requires authentication and proper authorization. Access is granted to the booking organizer and hosts, and to team or organization members whose role can view the booking and has the booking.readRecordings permission, which team and organization admins and owners have by default. cal-api-version: 2026-02-25 is required in the request header. This endpoint is rate-limited to 60 requests per minute per caller (per API key, access token, OAuth client, or IP). Exceeding the limit returns a 429 response and blocks further calls for 60 seconds. If the upstream conferencing provider rate-limits the request, this endpoint responds with HTTP 429 and a Retry-After header carrying the number of seconds to wait before retrying. Clients should honor this hint. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/conferencing-sessions - Write
Create a booking
POST /v2/bookings is used to create regular bookings, recurring bookings and instant bookings. The request bodies for all 3 are almost the same except: If eventTypeId in the request body is id of a regular event, then regular booking is created. If it is an id of a recurring event type, then recurring booking is created. Meaning that the request bodies are equal but the outcome depends on what kind of event type it is with the goal of making it as seamless for developers as possible. For team event types it is possible to create instant meeting. To do that just pass "instant": true to the request body. If the event type has an instant meeting schedule, requests made outside it, or too close to its end for the meeting to fit, are rejected with a 400. The start needs to be in UTC aka if the timezone is GMT+2 in Rome and meeting should start at 11, then UTC time should have hours 09:00 aka without time zone. Finally, there are 2 ways to book an event type belonging to an individual user: 1. Provide eventTypeId in the request body. 2. Provide eventTypeSlug and username and optionally organizationSlug if the user with the username is within an organization. And 2 ways to book and event type belonging to a team: 1. Provide eventTypeId in the request body. 2. Provide eventTypeSlug and teamSlug and optionally organizationSlug if the team with the teamSlug is within an organization. If you are creating a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner. For event types that have SMS reminders workflow, you need to pass the attendee's phone number in the request body via attendee.phoneNumber (e.g., "+19876543210" in international format). This is an optional field, but becomes required when SMS reminders are enabled for the event type. For the complete attendee object structure, see the attendee object documentation. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
POST /v2/bookings - Write
Reschedule a booking
Reschedule a booking or seated booking. Reschedulable booking statuses: - accepted — the confirmed booking is moved to the new start time. - pending — a booking awaiting host confirmation can be rescheduled. The new booking stays pending until the host confirms or declines it. Non-reschedulable booking statuses (endpoint responds with 400 Bad Request): - cancelled — the booking has already been cancelled. If it was cancelled because it was previously rescheduled, the error message includes the UID of the booking it was rescheduled to. - rejected — the host declined the original confirmation-required request. Create a new booking instead. - awaitinghost — an instant meeting that is live and waiting for a host to join. Create a new booking instead. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
POST /v2/bookings/{bookingUid}/reschedule - Write
Mark a booking absence
The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/mark-absent - Write
Reassign a booking to a specific host
Currently only supports reassigning host for round robin bookings. The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/reassign/{userId} - Write
Confirm a booking
The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/confirm - Write
Confirm booking seats
Confirm selected seats on a booking whose event type requires confirmation and has seats. The authorization header refers to a host who can update the booking. confirmedSeatUids lists seats that were waiting and are now confirmed. Seats that were already confirmed stay confirmed and are omitted. POST /v2/bookings/:bookingUid/confirm refuses these bookings. Pass each seat's seatUid here instead. Available with cal-api-version 2024-08-13, 2026-02-25, and 2026-05-01. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/seats/confirm - Write
Decline booking seats
Decline selected seats on a booking whose event type requires confirmation and has seats. The authorization header refers to a host who can update the booking. declinedSeatUids lists seats that were waiting or confirmed and are now declined. Seats that were already declined stay declined and are omitted. A confirmed seat can be declined. An optional reason is stored on each declined seat and included in its decline email and booking-rejected workflow. POST /v2/bookings/:bookingUid/decline refuses these bookings. Pass each seat's seatUid here instead. Available with cal-api-version 2024-08-13, 2026-02-25, and 2026-05-01. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/seats/decline - Write
Decline a booking
The provided authorization header refers to the owner of the booking. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/decline - Write
Update booking location for an existing booking
Updates the booking location in Cal.com and updates the corresponding calendar event via the organizer's connected credentials. For integration locations (e.g. Zoom, Google Meet, Cal Video), the endpoint also provisions a conference link. Attendees are notified of the location change by email. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
PATCH /v2/bookings/{bookingUid}/location - Destructive
Cancel a booking
:bookingUid can be :bookingUid of an usual booking, individual recurrence or recurring booking to cancel all recurrences. Cancelling normal bookings: If the booking is not seated and not recurring, simply pass :bookingUid in the request URL /bookings/:bookingUid/cancel and optionally cancellationReason in the request body {"cancellationReason": "Will travel"}. Cancelling seated bookings: It is possible to cancel specific seat within a booking as an attendee or all of the seats as the host. 1. As an attendee - provide :bookingUid in the request URL /bookings/:bookingUid/cancel and seatUid in the request body {"seatUid": "123-123-123"} . This will remove this particular attendance from the booking. 2. As the host or org admin of host - host can cancel booking for all attendees aka for every seat, this also applies to org admins. Provide :bookingUid in the request URL /bookings/:bookingUid/cancel and cancellationReason in the request body {"cancellationReason": "Will travel"} and Authorization: Bearer token request header where token is event type owner (host) credential. This will cancel the booking for all attendees. Cancelling recurring seated bookings: For recurring seated bookings it is not possible to cancel all of them with 1 call like with non-seated recurring bookings by providing recurring bookind uid - you have to cancel each recurrence booking by its bookingUid + seatUid. If you are cancelling a seated booking for an event type with 'show attendees' disabled, then to retrieve attendees in the response either set 'show attendees' to true on event type level or you have to provide an authentication method of event type owner, host, team admin or owner or org admin or owner. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
POST /v2/bookings/{bookingUid}/cancel - Destructive
Reassign a booking
Reassigns the host of a round robin or managed event type booking. The provided authorization header refers to the owner of the booking. Without userUuid in the body, an available round robin host is picked automatically. With userUuid, the booking is reassigned to that user. For a round robin booking, the user must be one of the booking's hosts and the booking keeps its uid. For a managed event booking, the user must be one of the users the managed event is assigned to — list them, along with their availability for the booking's slot, with GET /v2/bookings/{bookingUid}/reassignment-candidates. Reassignment moves the booking onto the new host's own child event type, so the original booking is cancelled and the returned booking has a new uid which you must store in place of the old one. Recurring managed bookings cannot be reassigned yet. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/reassign - Destructive
Request to reschedule a booking
Request to reschedule a booking. The booking will be cancelled and the attendee will receive an email with a link to reschedule. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/request-reschedule
Bookings Email Verification
- Read
Check if email verification is required
Checks whether email verification is required for the given email. Returns true if verification is needed.
GET /v2/bookings/verification/email/check - Write
Send email verification code
Sends a one-time verification code to the specified email address.
POST /v2/bookings/verification/email/send-code - Write
Verify email with code
Verifies an email address using the one-time code that was previously sent.
POST /v2/bookings/verification/email/verify-code
Bookings / Attendees
- Read
Get all attendees for a booking
Retrieve all attendees for a specific booking by its UID. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/attendees - Read
Get a specific attendee for a booking
Retrieve a specific attendee by their ID for a booking identified by its UID. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/attendees/{attendeeId} - Write
Add an attendee to a booking
Add a new attendee to an existing booking by its UID. Seated Events: This endpoint does not support seated event bookings. For seated events, each attendee must be added by creating a new booking for the same event type and time slot via POST /v2/bookings. Attempting to add an attendee to a seated event booking will return a 400 error. Side effects: - The booking's attendee list is updated in the database - The calendar event is updated on connected calendars (Google Calendar, Outlook, etc.) to include the new attendee - An email notification is sent to the new attendee with the booking details Permissions: - The authenticated user must be either the booking organizer, an existing attendee, or have the booking.update permission for the team The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/attendees
Bookings / Guests
- Write
Add guests to an existing booking
Add one or more guests to an existing booking. Maximum 10 guests per request, with a limit of 30 total guests per booking. Rate Limiting: This endpoint is rate limited to 5 requests per minute to prevent abuse. Seated Events: This endpoint does not support seated event bookings. For seated events, each guest must be added by creating a new booking for the same event type and time slot via POST /v2/bookings. Attempting to add guests to a seated event booking will return a 400 error. Email Notifications: When guests are added, the following notifications are sent (unless disabled by event type settings): - Organizer & Team Members: Receive an "Add Guests" notification email informing them that new guests have been added to the booking. - New Guests: Receive a "Scheduled Event" email with full booking details and calendar invite. If they have a phone number, they also receive an SMS notification. - Existing Guests: Receive an "Add Guests" notification email informing them that additional guests have been added to the booking. The cal-api-version header is required for this endpoint. Without it, the request will fail with a 404 error. If accessed using an OAuth access token, the BOOKINGWRITE scope is required.
POST /v2/bookings/{bookingUid}/guests
Bookings / Routing Trace
- Read
Get the routing trace for a booking
Retrieve the step-by-step routing trace for a booking identified by its UID. Shows how the booking was routed through routing forms, CRM lookups, and host selection logic. Returns presented (human-readable) trace steps grouped by routing round, along with the routing form submission if one was used. If no routing trace exists for the booking, empty steps and groups are returned. The cal-api-version header is required for this endpoint. If accessed using an OAuth access token, the BOOKINGREAD scope is required.
GET /v2/bookings/{bookingUid}/routing-trace
Cal Unified Calendars
- Read
Get meeting details from calendar
Returns detailed information about a meeting including attendance metrics. If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/calendars/{calendar}/event/{eventUid} - Write
Update meeting details in calendar
Updates event information in the specified calendar provider. If accessed using an OAuth access token, the APPSWRITE scope is required.
PATCH /v2/calendars/{calendar}/events/{eventUid}
Calendars
- Read
Check an ICS feed
If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/calendars/ics-feed/check - Read
Get busy times
Get busy times from a calendar. Example request URL is https://api.cal.com/v2/calendars/busy-times?timeZone=Europe%2FMadrid&dateFrom=2024-12-18&dateTo=2024-12-18&calendar=135,skrauciz%40gmail.com&calendar=200,bob%40gmail.com. The calendar query parameter identifies one calendar as , , e.g. calendar=135,alice@example.com. Both values are returned for each connected calendar by GET /v2/calendars. To load busy times from multiple calendars, pass the calendar query parameter multiple times, e.g. calendar=135,alice@example.com&calendar=200,bob@example.com. Only the first comma separates the two values, so an externalId containing commas is kept intact. Note: loggedInUsersTz is deprecated, use timeZone instead. If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/calendars/busy-times - Read
Get all calendars
If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/calendars - Read
Get OAuth connect URL
If accessed using an OAuth access token, the APPSWRITE scope is required.
GET /v2/calendars/{calendar}/connect - Read
Check a calendar connection
If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/calendars/{calendar}/check - Write
Save an ICS feed
If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/calendars/ics-feed/save - Write
Save Google or Outlook calendar credentials
GET /v2/calendars/{calendar}/save
GET /v2/calendars/{calendar}/save - Write
Save Apple calendar credentials
If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/calendars/{calendar}/credentials - Destructive
Disconnect a calendar
If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/calendars/{calendar}/disconnect
Conferencing
- Read
Get OAuth conferencing app auth URL
Returns the URL to send the user to so they can authorize Zoom or Microsoft Teams. Redirect the user's browser to it - the provider then returns them to a callback already registered by Cal.com, which stores the credential against the owner of the access token that started the flow. returnTo and onErrorReturnTo must each be a relative path or an absolute http(s) URL. The returned URL expires 10 minutes after this call, so redirect immediately rather than caching it. Walkthrough: https://cal.com/docs/api-reference/v2/conferencing-apps. If accessed using an OAuth access token, the APPSWRITE scope is required.
GET /v2/conferencing/{app}/oauth/auth-url - Read
Conferencing app OAuth callback
GET /v2/conferencing/{app}/oauth/callback
GET /v2/conferencing/{app}/oauth/callback - Read
List your conferencing applications
If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/conferencing - Read
Get your default conferencing application
If accessed using an OAuth access token, the APPSREAD scope is required.
GET /v2/conferencing/default - Write
Connect your conferencing application
Only google-meet can be connected this way, and only for a user who already has a valid Google Calendar connection. Zoom and Microsoft Teams require an OAuth handshake - start it with GET /v2/conferencing/{app}/oauth/auth-url instead. Walkthrough: https://cal.com/docs/api-reference/v2/conferencing-apps. If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/conferencing/{app}/connect - Write
Set your default conferencing application
If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/conferencing/{app}/default - Destructive
Disconnect your conferencing application
If accessed using an OAuth access token, the APPSWRITE scope is required.
DELETE /v2/conferencing/{app}/disconnect
Credits
- Read
Check available credits
Check if the authenticated user (or their org/team) has available credits and return the current balance. Third-party OAuth tokens require the CREDITSREAD scope.
GET /v2/credits/available - Destructive
Charge credits
Charge credits for an authenticated user. Uses externalRef for idempotency to prevent double-charging. Third-party OAuth tokens require the CREDITSWRITE scope.
POST /v2/credits/charge
Deprecated: Platform / Managed Users
- Read
Get all managed users (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients/{clientId}/users - Read
Get a managed user (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients/{clientId}/users/{userId} - Write
Create a managed user (deprecated)
These endpoints are deprecated and will be removed in the future.
POST /v2/oauth-clients/{clientId}/users - Write
Update a managed user (deprecated)
These endpoints are deprecated and will be removed in the future.
PATCH /v2/oauth-clients/{clientId}/users/{userId} - Write
Force refresh tokens (deprecated)
These endpoints are deprecated and will be removed in the future. If you have lost managed user access or refresh token, then you can get new ones by using OAuth credentials. Access token is valid for 60 minutes and refresh token for 1 year. Make sure to store them in your database, for example, in your User database model calAccessToken and calRefreshToken fields. Response also contains accessTokenExpiresAt and refreshTokenExpiresAt fields, but if you decode the jwt token the payload will contain clientId (OAuth client ID), ownerId (user to whom token belongs ID), iat (issued at time) and expiresAt (when does the token expire) fields.
POST /v2/oauth-clients/{clientId}/users/{userId}/force-refresh - Write
Refresh managed user tokens (deprecated)
These endpoints are deprecated and will be removed in the future. If managed user access token is expired then get a new one using this endpoint - it will also refresh the refresh token, because we use "refresh token rotation" mechanism. Access token is valid for 60 minutes and refresh token for 1 year. Make sure to store them in your database, for example, in your User database model calAccessToken and calRefreshToken fields. Response also contains accessTokenExpiresAt and refreshTokenExpiresAt fields, but if you decode the jwt token the payload will contain clientId (OAuth client ID), ownerId (user to whom token belongs ID), iat (issued at time) and expiresAt (when does the token expire) fields.
POST /v2/oauth/{clientId}/refresh - Destructive
Delete a managed user (deprecated)
These endpoints are deprecated and will be removed in the future.
DELETE /v2/oauth-clients/{clientId}/users/{userId}
Deprecated: Platform / Webhooks
- Read
Get all webhooks (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients/{clientId}/webhooks - Read
Get a webhook (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients/{clientId}/webhooks/{webhookId} - Write
Create a webhook (deprecated)
These endpoints are deprecated and will be removed in the future.
POST /v2/oauth-clients/{clientId}/webhooks - Write
Update a webhook (deprecated)
These endpoints are deprecated and will be removed in the future.
PATCH /v2/oauth-clients/{clientId}/webhooks/{webhookId} - Destructive
Delete all webhooks (deprecated)
These endpoints are deprecated and will be removed in the future.
DELETE /v2/oauth-clients/{clientId}/webhooks - Destructive
Delete a webhook (deprecated)
These endpoints are deprecated and will be removed in the future.
DELETE /v2/oauth-clients/{clientId}/webhooks/{webhookId}
Deprecated: Platform OAuth Clients
- Read
Get all OAuth clients (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients - Read
Get an OAuth client (deprecated)
These endpoints are deprecated and will be removed in the future.
GET /v2/oauth-clients/{clientId} - Write
Create an OAuth client (deprecated)
These endpoints are deprecated and will be removed in the future.
POST /v2/oauth-clients - Write
Update an OAuth client (deprecated)
These endpoints are deprecated and will be removed in the future.
PATCH /v2/oauth-clients/{clientId} - Destructive
Delete an OAuth client (deprecated)
These endpoints are deprecated and will be removed in the future.
DELETE /v2/oauth-clients/{clientId}
Destination Calendars
- Destructive
Update destination calendars
If accessed using an OAuth access token, the APPSWRITE scope is required.
PUT /v2/destination-calendars
Event Types
- Read
Get event-type calendar-invite templates
Returns host and guest invite-description settings resolved from the event type, organization default when the mode is inherit, then Cal.com's standard description. Access matches reading the event type; OAuth clients require EVENTTYPEREAD. Custom templates are limited to 5,000 characters. Managed children inherit their parent's templates and are marked read-only. Host templates are private and are not included in event-type responses.
GET /v2/event-types/{eventTypeId}/calendar-invites - Read
List event types
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Hidden event types and hidden booking fields are returned only when listing your own event types. Other callers see public event types and visible booking fields.
GET /v2/event-types - Read
Get event type history
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required. Only the event type owner and applicable administrators can view its history. General event type read access does not include access to its history.
GET /v2/event-types/{eventTypeId}/history - Read
Get scheduling configuration
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. The response varies by the event type's scheduling type, and non-team event types are rejected. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/scheduling-config - Read
List CRM sync errors for an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. By default, only active CRM sync errors are returned; pass includeDismissed=true to include dismissed errors. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/crm-sync-errors - Read
Get an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns hidden booking fields only to callers who are allowed to view them. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId} - Read
Get booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns default and custom booking fields, plus any read-only workflow-added fields. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/booking-fields - Write
Update event-type calendar-invite templates
Updates host and/or guest settings without changing other event-type fields; omitted audiences remain unchanged. inherit uses the organization default, standard uses Cal.com's standard description, and custom uses a supplied template of at most 5,000 characters. HTML tags are stripped and Markdown links are kept. Managed children are read-only and return HTTP 400; update their parent. Access matches updating the event type; OAuth clients require EVENTTYPEWRITE.
PATCH /v2/event-types/{eventTypeId}/calendar-invites - Write
Create an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. If bookingFields is omitted, the event type is created with its default booking fields. At least one contact field—email or attendeePhoneNumber—must remain visible and required. Other default fields, such as additional notes, can be hidden. Provide bookingFields to customize the default fields or add custom booking fields. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
POST /v2/event-types - Write
Update an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Omit bookingFields to keep the existing booking fields. If provided, the array replaces them, and any omitted default fields are restored with their default settings. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
PATCH /v2/event-types/{eventTypeId} - Write
Add custom booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Adds custom booking fields. Default and workflow-added fields cannot be added through this endpoint. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
POST /v2/event-types/{eventTypeId}/booking-fields - Write
Update booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Updates the booking fields identified by slug. Omitted properties keep their current values. Workflow-added fields are read-only. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
PATCH /v2/event-types/{eventTypeId}/booking-fields - Destructive
Delete an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
DELETE /v2/event-types/{eventTypeId} - Destructive
Replace booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Replaces all booking fields. Omitted custom fields are deleted, while omitted default fields are restored with their default settings. Use PATCH to update specific fields. Workflow-added fields are read-only and ignored. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
PUT /v2/event-types/{eventTypeId}/booking-fields - Destructive
Delete a custom booking field
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Deletes the custom booking field identified by slug. Default fields cannot be deleted, set hidden instead. If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
DELETE /v2/event-types/{eventTypeId}/booking-fields/{slug}
Event Types / Webhooks
- Read
Get all webhooks
If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/webhooks - Read
Get a webhook
If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/webhooks/{webhookId} - Write
Create a webhook
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
POST /v2/event-types/{eventTypeId}/webhooks - Write
Update a webhook
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
PATCH /v2/event-types/{eventTypeId}/webhooks/{webhookId} - Destructive
Delete all webhooks
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
DELETE /v2/event-types/{eventTypeId}/webhooks - Destructive
Delete a webhook
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
DELETE /v2/event-types/{eventTypeId}/webhooks/{webhookId}
Event Types Private Links
- Read
Get all private links for an event type
If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/event-types/{eventTypeId}/private-links - Write
Create a private link for an event type
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
POST /v2/event-types/{eventTypeId}/private-links - Write
Update a private link for an event type
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
PATCH /v2/event-types/{eventTypeId}/private-links/{linkId} - Destructive
Delete a private link for an event type
If accessed using an OAuth access token, the EVENTTYPEWRITE scope is required.
DELETE /v2/event-types/{eventTypeId}/private-links/{linkId}
Events
- Read
List Events (cursor pagination)
Returns the Events the authenticated user hosts: Events they own, plus Events they have accepted a co-host invitation to. A co-hosted Event may be owned by a team, so a team-owned Event can appear here — but team-owned Events the user neither hosts nor co-hosts are not returned by this endpoint; list those with GET /v2/teams/{teamId}/events. Ordered by start time, newest first when status is omitted. Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. pagination.hasMore is false and pagination.nextCursor is null on the last page. Must pass cal-api-version: 2026-05-01 (or later). Older versions use take/skip offset pagination. Events are fixed-date RSVP pages served at cal.com/{slug}; they are not event types (bookable meeting templates) or calendar events. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events - Read
Get an Event
Returns one Event by UUID. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. Events are fixed-date RSVP pages served at cal.com/{slug}; they are not event types (bookable meeting templates) or calendar events. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid} - Read
List an Event's bookings
Returns the Event's guests in the statuses given by status, confirmed guests by default. A confirmed guest holds a seat on the Event's occurrence booking, the same way GET /v2/bookings reads attendees; pass status=PENDINGAPPROVAL to list the guests waiting for approval, WAITLISTED for the waitlist, or PENDINGPAYMENT for guests who have not paid yet. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.read. Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/bookings - Read
Check in a guest by registration id
Records a door check-in for one registration, the roster's manual tap (no QR involved). Same access as approving/declining guests — an external co-host may also work the door. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/registrations/{registrationId}/check-in - Read
Check in a guest by scanned QR token
Redeems a scanned check-in QR token. The token is carried in the request body, never the URL, since URLs land in history and access logs. Same access as the by-id check-in; an external co-host may also work the door. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/check-ins - Read
Count an Event's guests
Returns how many of the Event's guests are in each status, how many answered each RSVP, how many are checked in and how many seats each location holds, as the roster's tabs show them. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.read. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/registrations/counts - Read
List an Event's co-hosts
Returns the Event's co-hosts in their display order, with pending and declined invitations alongside accepted co-hosts. Co-hosts are people invited by email to help run the Event without joining the owning team. Unlike hosts — the owner and the team members on the Event's host roster, who can do everything — an accepted co-host can view and edit the Event's details and manage its guests (invite, approve, check in), but cannot publish, cancel or delete the Event, change its pricing, or manage co-hosts. An invitation grants nothing until the invitee accepts it while signed in with the invited email address. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team; an accepted co-host sees only the accepted co-hosts. PBAC permission for team events: calEvent.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/co-hosts - Read
Search the team members who can host an Event
Returns the accepted members of the team that owns the Event, so you can pick who to send in hosts when updating the Event with PATCH /v2/events/{uuid}. Members whose invitation to the team is still pending are left out. search matches name or email, case-insensitive. The order of the members is unspecified; sort them on your side if you show them sorted. Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. Only team Events have host candidates; a personal Event returns 400. The authenticated user must be able to update the Event: its owner, one of its hosts, or a team member with the permission below. An accepted co-host cannot change hosts and gets 404, exactly like an unknown uuid. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
GET /v2/events/{uuid}/host-candidates - Read
Get an Event's coordinates
Returns the latitude and longitude shown on the map of the Event's public page. Update them with PATCH /v2/events/{uuid}/coordinates. The Event must have an address location. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/coordinates - Read
Get an Event's locations
Returns the Event's locations, each with its id, in the same shape as locations on GET /v2/events/{uuid}. A location this API version can't represent is returned as type: "unknown". The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/locations - Read
List the messages sent to an Event's guests
Returns the Event's messages, newest first, with their delivery status. The authenticated user must be the Event's owner, one of its hosts, or a member of the owning team. Co-hosts cannot message guests. PBAC permission for team events: calEvent.update. Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. If accessed using an OAuth access token, the EVENTREAD scope is required.
GET /v2/events/{uuid}/messages - Write
Create an Event
Creates a draft Event for the authenticated user. A draft is not public and nobody can register until it is published with POST /v2/events/{uuid}/publish. To create an Event owned by a team, use POST /v2/teams/{teamId}/events. startTime and endTime are ISO 8601 in UTC; startTime must not be in the past and endTime must be after startTime. guestList controls whether guests see names, a count, or neither. locations sets where the Event happens; set price and currency on a location to charge for that place. Events are fixed-date RSVP pages served at cal.com/{slug}; they are not event types (bookable meeting templates) or calendar events. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events - Write
Update an Event
Updates the properties sent and leaves every other property as it is. Takes the same properties as POST /v2/events except locations, which have their own endpoints under /v2/events/{uuid}/locations. hosts, liveStreams, registrationFields, lineup and schedule replace the whole stored list. lineup: null removes the lineup. Pass null to capacity for unlimited guests. The slug and the guest list can't change once the Event is published, and a cancelled Event can't be updated. New times must keep every schedule item inside the Event. An accepted co-host can update the Event but not its hosts, slug or policies such as visibility, guestList or requiresApproval. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
PATCH /v2/events/{uuid} - Write
Publish an Event
Takes a draft Event live: its public page becomes reachable, guests can RSVP, the occurrence lands on the hosts' calendars. Idempotent for an Event that is already published. A cancelled Event cannot be published. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an external co-host gets 404, exactly like an unknown uuid. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/publish - Write
Approve every pending guest
Approves the Event's guests waiting for approval, optionally only those matching search or registered for locationId, as the roster's Approve all does. A free Event approves them in this request and returns completed with the counts. A paid Event sends each guest a payment request in the background and returns started. The Event must be published and not cancelled. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/registrations/approve-all - Write
Approve a guest
Approves one guest waiting for approval, as the roster's Approve does. On a free Event the guest gets a seat and kind is confirmed; when the Event is full the guest stays pending and kind is eventfullofferwaitlist. On a paid Event the guest is sent a payment request and kind is paymentpending. The Event must be published and not cancelled. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/registrations/{registrationId}/approve - Write
Decline a guest
Declines one guest waiting for approval or on the waitlist, as the roster's Decline does, and emails them. kind is declined. A guest can be declined even when the Event is cancelled. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/registrations/{registrationId}/decline - Write
Invite a co-host to an Event
Invites an email address to co-host the Event and emails it a link to accept, valid for 7 days. See GET /v2/events/{uuid}/co-hosts for what a co-host can do. The new invitation joins the end of the co-host list; re-inviting an address that is already invited sends a fresh link and keeps its place, and re-inviting an accepted co-host changes nothing. Rate limited per user. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an accepted co-host cannot invite and gets 404, exactly like an unknown uuid. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/co-hosts - Write
Reorder an Event's co-hosts
Saves the display order of the Event's co-hosts. coHostIds must name every co-host on the Event, accepted and pending alike, exactly once; a list that went stale under a concurrent invite or removal is refused with 400 and nothing is saved. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an accepted co-host cannot reorder and gets 404, exactly like an unknown uuid. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
PATCH /v2/events/{uuid}/co-hosts/order - Write
Update an Event's coordinates
Moves where the Event's address location sits on the map of its public page and re-renders the map. The Event must have an address location. The coordinates must stay within 1 km of where the address geocodes to; coordinates within a few metres of it reset to the address. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. Rate limited to 5 requests per minute per API key or access token. If accessed using an OAuth access token, the EVENTWRITE scope is required.
PATCH /v2/events/{uuid}/coordinates - Write
Upload an Event cover image
Uploads a JPEG, PNG or WebP image of at most 10 MB as the Event's cover, replacing the current cover and any poster design. The response carries the image's public URL and its dimensions as displayed. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/cover-image - Write
Add a location to an Event
Adds one location after the Event's existing locations and returns it with its id. Takes the same shape as an item of locations on POST /v2/events. Every existing location is kept as it is, including one this API version can't represent. An Event can have one address and one conferencing location, either an integration or the organizer's default app; links can repeat. On a published Event, a new location can't change what guests who already registered are charged, and adding it emails the guests. If the Event changes while the location is being added, nothing is saved and 409 is returned. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team; an accepted co-host can only add a free location. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/locations - Write
Edit an Event's location
Changes the fields sent and keeps the rest of the location, including its id. type is required and must match the stored location; to change it, delete the location and add a new one. Pass null for label, price or capacity to remove it. A location returned as type: "unknown" can't be edited. On a published Event, a location's price and currency can't change, and changing a location emails the guests. If the Event changes while the location is being saved, nothing is saved and 409 is returned. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team; an accepted co-host can't change a price. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
PATCH /v2/events/{uuid}/locations/{locationId} - Write
Upload an Event person avatar
Uploads a photo for a person in the Event's lineup or schedule and returns its public URL, which you then set as that person's avatarUrl when updating the Event. Uploading alone does not change the Event. Send the image as the multipart field file: JPEG, PNG or WebP, at most 2 MB and 2048 pixels on each side. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/person-avatar - Write
Message an Event's guests
Emails one segment of the Event's guests, optionally narrowed to one location or to guests who did or did not check in. Guests who have only a phone number are texted instead when texting is available; textRecipientCount says how many. The message is queued and sent in the background; list the Event's messages to follow its status. The authenticated user must be the Event's owner, one of its hosts, or a member of the owning team. Co-hosts cannot message guests. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/messages - Write
Invite guests to an Event
Emails an invitation to each address. Addresses that are already invited or registered are skipped, and the response reports what happened to every address. The Event must be published, not cancelled and not started yet, and the authenticated user must have a verified email. An Event holds at most 200 active invitations. The authenticated user must be the Event's owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/invitations - Destructive
Delete an Event
Removes an Event, its registrations and its occurrence booking. An upcoming published Event is cancelled first, notifying its guests, and disappears from listings immediately; it is permanently removed once those notices have gone out. An Event cancelled more than seven days earlier is removed at once. An ended Event that still has confirmed guests cannot be deleted, and a published paid Event cannot be deleted because its payment records are retained. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an external co-host gets 404. PBAC permission for team events: calEvent.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
DELETE /v2/events/{uuid} - Destructive
Cancel an Event
Cancels a published Event and notifies every registered guest; paid registrations are refunded. The Event stays listed with cancelledAt set. Drafts cannot be cancelled (delete them instead) and neither can Events that already ended. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an external co-host gets 404. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
POST /v2/events/{uuid}/cancel - Destructive
Undo a guest's check-in
Clears a mistaken door check-in. Idempotent: undoing an unchecked registration is a no-op report. Not gated by the event's check-in window — undo corrects the host's own record rather than recording attendance. PBAC permission for team events: calEvent.update. If accessed using an OAuth access token, the EVENTWRITE scope is required.
DELETE /v2/events/{uuid}/registrations/{registrationId}/check-in - Destructive
Remove a co-host from an Event
Removes an accepted co-host, or cancels a pending invitation so its link stops working. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an accepted co-host cannot remove anyone and gets 404, exactly like an unknown uuid. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
DELETE /v2/events/{uuid}/co-hosts/{coHostId} - Destructive
Remove an Event cover image
Removes the Event's cover image and any poster design. Idempotent for an Event without a cover. The authenticated user must be its owner, one of its hosts, an accepted co-host, or a member of the owning team. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
DELETE /v2/events/{uuid}/cover-image - Destructive
Remove a location from an Event
Removes one location and returns the Event's remaining locations, in the same shape as GET /v2/events/{uuid}/locations. Every other location is kept as it is, including one this API version can't represent. On a published paid Event, locations can't be removed. On a published Event, removing a location emails the guests. If the Event changes while the location is being removed, nothing is saved and 409 is returned. The authenticated user must be its owner, one of its hosts, or a member of the owning team; an accepted co-host gets 403. PBAC permission for team events: calEvent.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the EVENTWRITE scope is required.
DELETE /v2/events/{uuid}/locations/{locationId}
Insights
- Read
Get booking limits usage
How much of each booking limit is used in the day, week, month and year containing date (default today), per user in scope. Counts come from the same queries booking-limit enforcement uses. Reports the user's global limit and, when eventTypeId is given, the event type's own limit; team booking limits are not included yet. Team scope requires insights.read on the team, even for direct members. Org scope requires eventTypeId and lists that event's hosts. An admin skipBookingLimits override can still let a booking through when remaining is 0.
POST /v2/insights/booking-limits/usage - Read
Get booking KPI stats
Get booking KPI stats for user, team, or organization insights.
POST /v2/insights/bookings/kpi-stats - Read
Get booking event trends
Get booking trend stats for user, team, or organization insights.
POST /v2/insights/bookings/event-trends - Read
Get average booking duration
Get average booking duration for user, team, or organization insights.
POST /v2/insights/bookings/average-duration - Read
Get booking member stats
Get booking member stats for user, team, or organization insights.
POST /v2/insights/bookings/members - Read
Get routing forms by status
Get routing form response counts by booking status for user, team, or organization insights.
POST /v2/insights/routings/forms-by-status - Read
Get routing form responses
Get paginated routing form responses for user, team, or organization insights.
POST /v2/insights/routings/form-responses - Read
Get routing form field options
Get routing form fields and options for user, team, or organization insights.
POST /v2/insights/routings/form-field-options - Read
Get routing form response headers
Get routing form response headers for user, team, or organization insights.
POST /v2/insights/routings/form-response-headers - Read
Get failed bookings by routing field
Get failed booking counts grouped by routing form field for user, team, or organization insights.
POST /v2/insights/routings/failed-bookings-by-field - Read
Get routed-to users per period
Get routed-to booking counts by user and period for user, team, or organization insights.
POST /v2/insights/routings/routed-to-per-period
Links
- Read
Get a link
Returns hidden booking fields only to callers who are allowed to view them. If accessed using an OAuth access token, the EVENTTYPEREAD scope is required.
GET /v2/links/{linkUid}
Managed Orgs
- Read
Get all organizations within an organization
For platform, the plan must be 'SCALE' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.readManagedOrganizations. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/organizations - Read
Get an organization within an organization
For platform, the plan must be 'SCALE' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.readManagedOrganizations. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
GET /v2/organizations/{orgId}/organizations/{managedOrganizationId} - Write
Create an organization within an organization
For platform, the plan must be 'SCALE' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
POST /v2/organizations/{orgId}/organizations - Write
Update an organization within an organization
For platform, the plan must be 'SCALE' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
PATCH /v2/organizations/{orgId}/organizations/{managedOrganizationId} - Destructive
Delete an organization within an organization
For platform, the plan must be 'SCALE' or higher to access this endpoint. Required membership role: org admin. PBAC permission: organization.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control
DELETE /v2/organizations/{orgId}/organizations/{managedOrganizationId}
Me
- Read
Get my profile
If accessed using an OAuth access token, the PROFILEREAD scope is required.
GET /v2/me - Read
Get my booking limits
Returns the authenticated user's global booking limits. Unset bounds are returned as null. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILEREAD scope is required.
GET /v2/me/booking-limits - Write
Update my profile
Updates the authenticated user's profile. Email changes require verification and the primary email stays unchanged until verification completes, unless the new email is already a verified secondary email or the user is platform-managed. If accessed using an OAuth access token, the PROFILEWRITE scope is required.
PATCH /v2/me - Write
Update my booking limits
Partially updates the authenticated user's global booking limits. Only fields present in the request body are changed; omit a field to leave it untouched, or set it to null to remove that limit. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILEWRITE scope is required.
PATCH /v2/me/booking-limits - Destructive
Clear my booking limits
Removes all of the authenticated user's global booking limits. Only available to organization members — non-org accounts receive a 403. If accessed using an OAuth access token, the PROFILEWRITE scope is required.
DELETE /v2/me/booking-limits
Notifications
- Read
Get the agent notification channel selection
GET /v2/notifications/agent-channels
GET /v2/notifications/agent-channels - Write
Register an app push subscription
POST /v2/notifications/subscriptions/app-push
POST /v2/notifications/subscriptions/app-push - Write
Create a Slack push linking intent
POST /v2/notifications/subscriptions/slack/link-intents
POST /v2/notifications/subscriptions/slack/link-intents - Write
Create a Telegram push linking intent
POST /v2/notifications/subscriptions/telegram/link-intents
POST /v2/notifications/subscriptions/telegram/link-intents - Write
Create an iMessage push linking intent
POST /v2/notifications/subscriptions/imessage/link-intents
POST /v2/notifications/subscriptions/imessage/link-intents - Write
Enable or disable an agent notification channel
PATCH /v2/notifications/agent-channels/{channel}
PATCH /v2/notifications/agent-channels/{channel} - Destructive
Remove an app push subscription
DELETE /v2/notifications/subscriptions/app-push
DELETE /v2/notifications/subscriptions/app-push - Destructive
Remove a Slack push subscription
DELETE /v2/notifications/subscriptions/slack
DELETE /v2/notifications/subscriptions/slack - Destructive
Remove a Telegram push subscription
DELETE /v2/notifications/subscriptions/telegram
DELETE /v2/notifications/subscriptions/telegram - Destructive
Remove an iMessage push subscription
DELETE /v2/notifications/subscriptions/imessage
DELETE /v2/notifications/subscriptions/imessage
OAuth2
- Read
Get OAuth2 client
Returns the OAuth2 client information for the given client ID
GET /v2/auth/oauth2/clients/{clientId} - Write
Exchange authorization code or refresh token for tokens
RFC 6749-compliant token endpoint. Pass clientid in the request body (Section 2.3.1). Use granttype 'authorizationcode' to exchange an auth code for tokens, or 'refreshtoken' to refresh an access token. Accepts both application/x-www-form-urlencoded (standard per RFC 6749 Section 4.1.3) and application/json content types.
POST /v2/auth/oauth2/token
Organization Event Types
- Read
List organization team event types
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Hidden event types and hidden booking fields are returned only to team administrators or owners, and parent-organization administrators or owners. Other callers see public event types and visible booking fields. Authentication is optional.
GET /v2/organizations/{orgId}/teams/{teamId}/event-types - Read
Get an event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns hidden booking fields only to callers who are allowed to view them. Required membership role: team admin. PBAC permission: eventType.readTeamEventTypes. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId} - Read
Get organization team event-type calendar-invite templates
Returns host and guest settings resolved from the event type, organization default, then Cal.com's standard description. Access matches reading the team event type: the eventType.readTeamEventTypes PBAC permission, or team ADMIN/OWNER role when PBAC does not grant it. OAuth clients require TEAMEVENTTYPEREAD. Custom templates are limited to 5,000 characters. A team-scope mismatch returns 404. Managed children inherit their parent's settings and are marked read-only.
GET /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/calendar-invites - Read
Get all team event types
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Use the optional sortCreatedAt query parameter to order results by creation date (by ID). Accepts "asc" (oldest first) or "desc" (newest first). When not provided, no explicit ordering is applied. Required membership role: org admin. PBAC permission: eventType.readOrgEventTypes. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the ORGEVENTTYPEREAD scope is required.
GET /v2/organizations/{orgId}/teams/event-types - Read
Get organization team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns default and custom booking fields, plus any read-only workflow-added fields. Required membership role: team admin. PBAC permission: eventType.readTeamEventTypes. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Write
Create an organization team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If bookingFields is omitted, the event type is created with its default booking fields. At least one contact field—email or attendeePhoneNumber—must remain visible and required. Other default fields, such as additional notes, can be hidden. Provide bookingFields to customize the default fields or add custom booking fields. Required membership role: team admin. PBAC permission: eventType.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/event-types - Write
Update an organization team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Omit bookingFields to keep the existing booking fields. If provided, the array replaces them, and any omitted default fields are restored with their default settings. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId} - Write
Update organization team event-type calendar-invite templates
Updates one or both audiences without changing other event-type fields; omitted audiences remain unchanged. Access matches updating the team event type: the eventType.update PBAC permission, or team ADMIN/OWNER role when PBAC does not grant it. OAuth clients require TEAMEVENTTYPEWRITE. Custom templates are limited to 5,000 characters; HTML tags are stripped and Markdown links are kept. Managed children are read-only and return HTTP 400. A team-scope mismatch returns 404.
PATCH /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/calendar-invites - Write
Create a phone call for an organization team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/create-phone-call - Write
Add custom organization team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Adds custom booking fields. Default and workflow-added fields cannot be added through this endpoint. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Write
Update organization team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Updates the booking fields identified by slug. Omitted properties keep their current values. Workflow-added fields are read-only. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Write
Duplicate an organization team event type
Copies the event type into the target team, which is the source's team or another team of the same organization. In another team, hosts who are not accepted members of the target team are left out and no workflows are activated; the response lists both. The source's destination calendar is left off when the caller cannot set it, which the response reports in destinationCalendarDropped. Required membership role: team admin of the source's team. PBAC permission: eventType.create on the source's team; the caller also needs eventType.read on the source's team and eventType.create on the target team. A source the caller cannot read returns 404, the same as a missing one. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/duplicate - Destructive
Delete an organization team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Required membership role: team admin. PBAC permission: eventType.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId} - Destructive
Replace organization team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Replaces all booking fields. Omitted custom fields are deleted, while omitted default fields are restored with their default settings. Use PATCH to update specific fields. Workflow-added fields are read-only and ignored. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PUT /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Destructive
Delete a custom organization team booking field
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Deletes the custom booking field identified by slug. Default fields cannot be deleted, set hidden instead. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/organizations/{orgId}/teams/{teamId}/event-types/{eventTypeId}/booking-fields/{slug}
Organization Team Verified Resources
- Read
Get list of verified emails of an org team
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails - Read
Get list of verified phone numbers of an org team
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones - Read
Get verified email of an org team by id
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/{id} - Read
Get verified phone number of an org team by id
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/{id} - Write
Request email verification code
Sends a verification code to the email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/request - Write
Request phone number verification code
Sends a verification code to the phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/request - Write
Verify an email for an org team
Use code to verify an email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/verified-resources/emails/verification-code/verify - Write
Verify a phone number for an org team
Use code to verify a phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/organizations/{orgId}/teams/{teamId}/verified-resources/phones/verification-code/verify
Out of Office
- Read
Get all out-of-office entries for the authenticated user
If accessed using an OAuth access token, the SCHEDULEREAD scope is required.
GET /v2/me/ooo - Write
Create an out-of-office entry for the authenticated user
If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
POST /v2/me/ooo - Write
Update an out-of-office entry for the authenticated user
If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
PATCH /v2/me/ooo/{oooId} - Destructive
Delete an out-of-office entry for the authenticated user
If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
DELETE /v2/me/ooo/{oooId}
Routing forms
- Write
Calculate slots based on routing form response
It will not actually save the response just return the routed event type and slots when it can be booked.
POST /v2/routing-forms/{routingFormId}/calculate-slots
Schedules
- Read
Get all schedules
Get all schedules of the authenticated user. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEREAD scope is required.
GET /v2/schedules - Read
Get default schedule
Get the default schedule of the authenticated user. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEREAD scope is required.
GET /v2/schedules/default - Read
Get a schedule
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEREAD scope is required.
GET /v2/schedules/{scheduleId} - Write
Create a schedule
Create a schedule for the authenticated user. The point of creating schedules is for event types to be available at specific times. The first goal of schedules is to have a default schedule. If you are platform customer and created managed users, then it is important to note that each managed user should have a default schedule. 1. If you passed timeZone when creating managed user, then the default schedule from Monday to Friday from 9AM to 5PM will be created with that timezone. The managed user can then change the default schedule via the AvailabilitySettings atom. 2. If you did not, then we assume you want the user to have this specific schedule right away. You should create a default schedule by specifying "isDefault": true in the request body. Until the user has a default schedule the user can't be booked nor manage their schedule via the AvailabilitySettings atom. The second goal of schedules is to create another schedule that event types can point to. This is useful for when an event is booked because availability is not checked against the default schedule but instead against that specific schedule. After creating a non-default schedule, you can update an event type to point to that schedule via the PATCH event-types/{eventTypeId} endpoint. When specifying start time and end time for each day use the 24 hour format e.g. 08:00, 15:00 etc. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
POST /v2/schedules - Write
Update a schedule
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
PATCH /v2/schedules/{scheduleId} - Destructive
Delete a schedule
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If accessed using an OAuth access token, the SCHEDULEWRITE scope is required.
DELETE /v2/schedules/{scheduleId}
Selected Calendars
- Write
Add a selected calendar
If accessed using an OAuth access token, the APPSWRITE scope is required.
POST /v2/selected-calendars - Destructive
Delete a selected calendar
If accessed using an OAuth access token, the APPSWRITE scope is required.
DELETE /v2/selected-calendars
Slots
- Read
Get available time slots for an event type
There are 4 ways to get available slots for event type of an individual user: 1. By event type id. Example '/v2/slots?eventTypeId=10&start=2033-09-05&end=2033-09-06&timeZone=Europe/Rome' 2. By event type slug + username. Example '/v2/slots?eventTypeSlug=intro&username=bob&start=2033-09-05&end=2033-09-06' 3. By event type slug + username + organization slug when searching within an organization. Example '/v2/slots?organizationSlug=org-slug&eventTypeSlug=intro&username=bob&start=2033-09-05&end=2033-09-06' 4. By usernames only (used for dynamic event type - there is no specific event but you want to know when 2 or more people are available). Example '/v2/slots?usernames=alice,bob&username=bob&organizationSlug=org-slug&start=2033-09-05&end=2033-09-06'. As you see you also need to provide the slug of the organization to which each user in the 'usernames' array belongs. And 3 ways to get available slots for team event type: 1. By team event type id. Example '/v2/slots?eventTypeId=10&start=2033-09-05&end=2033-09-06&timeZone=Europe/Rome'. Note for managed event types: Managed event types are templates that create individual child event types for each team member. You cannot fetch slots for the parent managed event type directly. Instead, you must: - Find the child event type IDs (the ones assigned to specific users) - Use those child event type IDs to fetch slots as individual user event types using as described in the individual user section above. 2. By team event type slug + team slug. Example '/v2/slots?eventTypeSlug=intro&teamSlug=team-slug&start=2033-09-05&end=2033-09-06' 3. By team event type slug + team slug + organization slug when searching within an organization. Example '/v2/slots?organizationSlug=org-slug&eventTypeSlug=intro&teamSlug=team-slug&start=2033-09-05&end=2033-09-06' All of them require "start" and "end" query parameters which define the time range for which available slots should be checked. Optional parameters are: - timeZone: Time zone in which the available slots should be returned. Defaults to UTC. - duration: Only use for event types that allow multiple durations or for dynamic event types. If not passed for multiple duration event types defaults to default duration. For dynamic event types defaults to 30 aka each returned slot is 30 minutes long. So duration=60 means that returned slots will be each 60 minutes long. - format: Format of the slots. By default return is an object where each key is date and value is array of slots as string. If you want to get start and end of each slot use "range" as value. - bookingUidToReschedule: When rescheduling an existing booking, provide the booking's unique identifier to exclude its time slot from busy time calculations. This ensures the original booking time appears as available for rescheduling. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
GET /v2/slots - Read
Get reserved slot
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
GET /v2/slots/reservations/{uid} - Write
Reserve a slot
Make a slot not available for others to book for a certain period of time. If you authenticate using oAuth credentials, api key or access token then you can also specify custom duration for how long the slot should be reserved for (defaults to 5 minutes). Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
POST /v2/slots/reservations - Write
Update a reserved slot
If you specify a custom reservation duration, you must authenticate using oAuth credentials, api key or access token. Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
PATCH /v2/slots/reservations/{uid} - Destructive
Delete a reserved slot
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint.
DELETE /v2/slots/reservations/{uid}
Stripe
- Read
Get Stripe connect URL
GET /v2/stripe/connect
GET /v2/stripe/connect - Read
Check Stripe connection
GET /v2/stripe/check
GET /v2/stripe/check - Write
Save Stripe credentials
GET /v2/stripe/save
GET /v2/stripe/save
Team Event Types
- Read
List team event types
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Hidden event types and hidden booking fields are returned only to team administrators or owners, and parent-organization administrators or owners. Other callers see public event types and visible booking fields. Authentication is optional.
GET /v2/teams/{teamId}/event-types - Read
Get a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns hidden booking fields only to callers who are allowed to view them. Required membership role: team admin. PBAC permission: eventType.readTeamEventTypes. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/teams/{teamId}/event-types/{eventTypeId} - Read
Get team event-type calendar-invite templates
Returns host and guest settings resolved from the event type, an organization default when available, then Cal.com's standard description. Access matches reading the team event type: the eventType.readTeamEventTypes PBAC permission, or team ADMIN/OWNER role when PBAC does not grant it. OAuth clients require TEAMEVENTTYPEREAD. Custom templates are limited to 5,000 characters. Event types outside the requested team return 404. Managed children inherit their parent's settings and are marked read-only.
GET /v2/teams/{teamId}/event-types/{eventTypeId}/calendar-invites - Read
Get team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Returns default and custom booking fields, plus any read-only workflow-added fields. Required membership role: team admin. PBAC permission: eventType.readTeamEventTypes. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Write
Create a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. If bookingFields is omitted, the event type is created with its default booking fields. At least one contact field—email or attendeePhoneNumber—must remain visible and required. Other default fields, such as additional notes, can be hidden. Provide bookingFields to customize the default fields or add custom booking fields. Required membership role: team admin. PBAC permission: eventType.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/teams/{teamId}/event-types - Write
Update a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Omit bookingFields to keep the existing booking fields. If provided, the array replaces them, and any omitted default fields are restored with their default settings. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/teams/{teamId}/event-types/{eventTypeId} - Write
Update team event-type calendar-invite templates
Updates one or both audiences without changing other event-type fields; omitted audiences remain unchanged. Access matches updating the team event type: the eventType.update PBAC permission, or team ADMIN/OWNER role when PBAC does not grant it. OAuth clients require TEAMEVENTTYPEWRITE. Custom templates are limited to 5,000 characters; HTML tags are stripped and Markdown links are kept. Managed children are read-only and return HTTP 400. Event types outside the requested team return 404.
PATCH /v2/teams/{teamId}/event-types/{eventTypeId}/calendar-invites - Write
Create a phone call for a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/teams/{teamId}/event-types/{eventTypeId}/create-phone-call - Write
Add custom team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Adds custom booking fields. Default and workflow-added fields cannot be added through this endpoint. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Write
Update team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Updates the booking fields identified by slug. Omitted properties keep their current values. Workflow-added fields are read-only. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Destructive
Delete a team event type
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Required membership role: team admin. PBAC permission: eventType.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/event-types/{eventTypeId} - Destructive
Replace team booking fields
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Replaces all booking fields. Omitted custom fields are deleted, while omitted default fields are restored with their default settings. Use PATCH to update specific fields. Workflow-added fields are read-only and ignored. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PUT /v2/teams/{teamId}/event-types/{eventTypeId}/booking-fields - Destructive
Delete a custom team booking field
Please make sure to pass in the cal-api-version header value as mentioned in the Headers section. Not passing the correct value will default to an older version of this endpoint. Deletes the custom booking field identified by slug. Default fields cannot be deleted, set hidden instead. Required membership role: team admin. PBAC permission: eventType.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/event-types/{eventTypeId}/booking-fields/{slug}
Teams
- Read
Get a team
If accessed using an OAuth access token, the TEAMPROFILEREAD scope is required.
GET /v2/teams/{teamId} - Read
Get teams
If accessed using an OAuth access token, the TEAMPROFILEREAD scope is required.
GET /v2/teams - Write
Update a team
Required membership role: team owner. PBAC permission: team.update, or organization.update when the team id is an organization. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMPROFILEWRITE scope is required.
PATCH /v2/teams/{teamId} - Destructive
Delete a team
Required membership role: team owner. PBAC permission: team.delete, or organization.delete when the team id is an organization. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMPROFILEWRITE scope is required.
DELETE /v2/teams/{teamId}
Teams / Booking limit pools
- Read
List booking limit pools
Returns the team's booking limit pools and its round-robin event types that can be in one. Requires an accepted membership of the team. If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/teams/{teamId}/booking-limit-pools - Read
List a pool's hosts and their limits
Returns the rotating hosts of the pool's event types in user id order, each with their own limit and the limit enforced for them. Requires permission to update the team's event types, since a host's limit can reveal their overall booking limit. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
GET /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts - Write
Create a booking limit pool
Caps how many bookings each rotating host takes across the pool's round-robin event types. Set at least one interval. Requires permission to update the team's event types. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/teams/{teamId}/booking-limit-pools - Write
Update a booking limit pool
Changes only the fields sent. An interval sent as null is removed. Changing the mode or event types keeps every host's own limit. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/teams/{teamId}/booking-limit-pools/{poolId} - Write
Set a host's limit for a pool
Sets the host's own limit for the intervals sent; null returns that interval to the pool's limit. Only intervals the pool limits can be set, and each is capped at the host's overall booking limit. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts/{userId} - Destructive
Delete a booking limit pool
Deletes the pool and the hosts' own limits for it. Its event types go back to their own per-host settings. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/booking-limit-pools/{poolId} - Destructive
Replace a host's limit for a pool
Replaces the host's own limit with the intervals sent; an omitted interval returns to the pool's limit, so sending the same body again changes nothing. Only intervals the pool limits can be set, and each is capped at the host's overall booking limit. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PUT /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts/{userId} - Destructive
Clear a host's limit for a pool
Returns the host to the pool's limits. If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/booking-limit-pools/{poolId}/hosts/{userId}
Teams / Bookings
- Read
Get team bookings
Required membership role: team admin. PBAC permission: booking.readTeamBookings. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMBOOKINGREAD scope is required.
GET /v2/teams/{teamId}/bookings
Teams / Event Types / Webhooks
- Read
Get all webhooks for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks - Read
Get a webhook for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEREAD scope is required.
GET /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId} - Write
Create a webhook for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
POST /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks - Write
Update a webhook for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
PATCH /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId} - Destructive
Delete all webhooks for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks - Destructive
Delete a webhook for a team event type
If accessed using an OAuth access token, the TEAMEVENTTYPEWRITE scope is required.
DELETE /v2/teams/{teamId}/event-types/{eventTypeId}/webhooks/{webhookId}
Teams / Events
- Read
List a team's Events (cursor pagination)
Returns every Event the team owns, including ones the authenticated user neither hosts nor co-hosts. The user must be an accepted member of the team, or of its parent organization. PBAC permission: calEvent.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. Ordered by start time, newest first when status is omitted. Cursor-based pagination: pass pagination.nextCursor from a previous response as the cursor query parameter to fetch the next page; omit cursor for the first page. pagination.hasMore is false and pagination.nextCursor is null on the last page. Must pass cal-api-version: 2026-05-01 (or later). Older versions use take/skip offset pagination. Events are fixed-date RSVP pages served at cal.com/{slug}; they are not event types (bookable meeting templates) or calendar events. If accessed using an OAuth access token, the TEAMEVENTREAD scope is required.
GET /v2/teams/{teamId}/events - Write
Create a team Event
Creates a draft Event owned by the team. A draft is not public and nobody can register until it is published with POST /v2/events/{uuid}/publish. The user must be an accepted member of the team, or of its parent organization. PBAC permission: calEvent.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. startTime and endTime are ISO 8601 in UTC; startTime must not be in the past and endTime must be after startTime. guestList controls whether guests see names, a count, or neither. locations sets where the Event happens; set price and currency on a location to charge for that place. Events are fixed-date RSVP pages served at cal.com/{slug}; they are not event types (bookable meeting templates) or calendar events. If accessed using an OAuth access token, the TEAMEVENTWRITE scope is required.
POST /v2/teams/{teamId}/events
Teams / Invite
- Write
Create team invite link
Required membership role: team admin. PBAC permission: team.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
POST /v2/teams/{teamId}/invite
Teams / Memberships
- Read
Get all memberships
Retrieve team memberships with optional filtering by email addresses. Supports pagination. Required membership role: team admin. PBAC permission: team.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPREAD scope is required.
GET /v2/teams/{teamId}/memberships - Read
Get a membership
Required membership role: team admin. PBAC permission: team.readMemberships. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPREAD scope is required.
GET /v2/teams/{teamId}/memberships/{membershipId} - Write
Create a membership
Required membership role: team admin. PBAC permission: team.invite. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
POST /v2/teams/{teamId}/memberships - Write
Update membership
Required membership role: team admin. PBAC permission: team.changeMemberRole. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
PATCH /v2/teams/{teamId}/memberships/{membershipId} - Destructive
Delete a membership
Required membership role: team admin. PBAC permission: team.remove. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMMEMBERSHIPWRITE scope is required.
DELETE /v2/teams/{teamId}/memberships/{membershipId}
Teams / Routing forms / Responses
- Write
Create routing form response and get available slots
Only available for teams that are not part of an organization - for a team within an organization use the organization team endpoint instead. Required membership role: team member. PBAC permission: routingForm.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMROUTINGFORMWRITE scope is required.
POST /v2/teams/{teamId}/routing-forms/{routingFormId}/responses
Teams / Schedules
- Read
Get all team member schedules
Required membership role: team admin. PBAC permission: availability.readTeamAvailability. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEREAD scope is required.
GET /v2/teams/{teamId}/schedules
Teams / Users / OOO
- Read
Get all out-of-office entries for a team member
Required membership role: team admin. PBAC permission: ooo.read. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEREAD scope is required.
GET /v2/teams/{teamId}/users/{userId}/ooo - Write
Create an out-of-office entry for a team member
Required membership role: team admin. PBAC permission: ooo.create. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEWRITE scope is required.
POST /v2/teams/{teamId}/users/{userId}/ooo - Write
Update an out-of-office entry for a team member
Required membership role: team admin. PBAC permission: ooo.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEWRITE scope is required.
PATCH /v2/teams/{teamId}/users/{userId}/ooo/{oooId} - Destructive
Delete an out-of-office entry for a team member
Required membership role: team admin. PBAC permission: ooo.delete. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMSCHEDULEWRITE scope is required.
DELETE /v2/teams/{teamId}/users/{userId}/ooo/{oooId}
Teams Verified Resources
- Read
Get list of verified emails of a team
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/teams/{teamId}/verified-resources/emails - Read
Get list of verified phone numbers of a team
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/teams/{teamId}/verified-resources/phones - Read
Get verified email of a team by id
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/teams/{teamId}/verified-resources/emails/{id} - Read
Get verified phone number of a team by id
Required membership role: team admin. PBAC permission: team.readVerifiedResources. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESREAD scope is required.
GET /v2/teams/{teamId}/verified-resources/phones/{id} - Write
Request email verification code
Sends a verification code to the Email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/teams/{teamId}/verified-resources/emails/verification-code/request - Write
Request phone number verification code
Sends a verification code to the phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/teams/{teamId}/verified-resources/phones/verification-code/request - Write
Verify an email for a team
Use code to verify an email. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/teams/{teamId}/verified-resources/emails/verification-code/verify - Write
Verify a phone number for an org team
Use code to verify a phone number. Required membership role: team admin. PBAC permission: team.update. Learn more about API access control at https://cal.com/docs/api-reference/v2/access-control. If accessed using an OAuth access token, the TEAMVERIFIEDRESOURCESWRITE scope is required.
POST /v2/teams/{teamId}/verified-resources/phones/verification-code/verify
Timezones
- Read
Get timezones
Returns the cities Cal.com knows a timezone for, as a city to show the user and the IANA timezone to store and to send back to Cal.com. Without search every city is returned, around 7000 of them. search searches the full source dataset by city name and additionally matches timezone names, so a search for an abbreviation such as PDT resolves to { "city": "Pacific Time - US & Canada", "timezone": "America/LosAngeles" }. City and alias names match by case-insensitive substring; complete IANA identifiers also match by case-insensitive equality. Partial IANA identifiers are not matched; timezone matches come first, then cities ordered by population, so the most likely answer is first. City results include country and region to distinguish same-named cities. Each city name and timezone pair appears once; display the location fields alongside the city and let the user choose. Timezone entries have no pop, country or region. Cal.com stores the IANA identifier, never an abbreviation or an offset: America/LosAngeles already means PDT in summer and PST in winter, and the response has no offset to interpret.
GET /v2/timezones
Verified Resources
- Read
Get list of verified emails
If accessed using an OAuth access token, the VERIFIEDRESOURCESREAD scope is required.
GET /v2/verified-resources/emails - Read
Get list of verified phone numbers
If accessed using an OAuth access token, the VERIFIEDRESOURCESREAD scope is required.
GET /v2/verified-resources/phones - Read
Get verified email by id
If accessed using an OAuth access token, the VERIFIEDRESOURCESREAD scope is required.
GET /v2/verified-resources/emails/{id} - Read
Get verified phone number by id
If accessed using an OAuth access token, the VERIFIEDRESOURCESREAD scope is required.
GET /v2/verified-resources/phones/{id} - Write
Request email verification code
Sends a verification code to the email. If accessed using an OAuth access token, the VERIFIEDRESOURCESWRITE scope is required.
POST /v2/verified-resources/emails/verification-code/request - Write
Request phone number verification code
Sends a verification code to the phone number. If accessed using an OAuth access token, the VERIFIEDRESOURCESWRITE scope is required.
POST /v2/verified-resources/phones/verification-code/request - Write
Verify an email
Use code to verify an email. If accessed using an OAuth access token, the VERIFIEDRESOURCESWRITE scope is required.
POST /v2/verified-resources/emails/verification-code/verify - Write
Verify a phone number
Use code to verify a phone number. If accessed using an OAuth access token, the VERIFIEDRESOURCESWRITE scope is required.
POST /v2/verified-resources/phones/verification-code/verify
Webhooks
- Read
Get all webhooks
Gets a paginated list of webhooks for the authenticated user. If accessed using an OAuth access token, the WEBHOOKREAD scope is required.
GET /v2/webhooks - Read
Get a webhook
If accessed using an OAuth access token, the WEBHOOKREAD scope is required.
GET /v2/webhooks/{webhookId} - Write
Create a webhook
If accessed using an OAuth access token, the WEBHOOKWRITE scope is required.
POST /v2/webhooks - Write
Update a webhook
If accessed using an OAuth access token, the WEBHOOKWRITE scope is required.
PATCH /v2/webhooks/{webhookId} - Destructive
Delete a webhook
If accessed using an OAuth access token, the WEBHOOKWRITE scope is required.
DELETE /v2/webhooks/{webhookId}
Workflows
- Read
Get your workflows
Get the event-type workflows owned by the authenticated user. Routing form workflows are not returned. Not available to third-party OAuth access tokens.
GET /v2/workflows - Read
Get your workflow
Get an event-type workflow owned by the authenticated user. Routing form workflows are not addressable through this endpoint. Not available to third-party OAuth access tokens.
GET /v2/workflows/{workflowId} - Read
Get the fields a workflow's conditions can read
List the fields a conditional path on this workflow can be written against, with the comparisons each one accepts and how both read in the Cal.com app. The catalog comes from what the workflow is active on — booking questions on its active event types — so it also reports the entities that do not ask for a field. Not available to third-party OAuth access tokens.
GET /v2/workflows/{workflowId}/condition-fields - Write
Create a workflow
Create an event-type workflow owned by the authenticated user. Not available to third-party OAuth access tokens.
POST /v2/workflows - Write
Update your workflow
Update an event-type workflow owned by the authenticated user. Not available to third-party OAuth access tokens.
PATCH /v2/workflows/{workflowId} - Destructive
Delete your workflow
Delete an event-type workflow owned by the authenticated user. Not available to third-party OAuth access tokens.
DELETE /v2/workflows/{workflowId}
No operations match.
Get started
- Open Space settings → Connections and search for Cal.
- Connect your account and add the connection to the Space.
- Ask for what you need in any thread in that Space.
See How connections work for access and permissions, or browse all integrations.