Skip to content
Changelog

Report a bug

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

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 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

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

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}

Get started

  1. Open Space settings → Connections and search for Cal.
  2. Connect your account and add the connection to the Space.
  3. Ask for what you need in any thread in that Space.

See How connections work for access and permissions, or browse all integrations.