Reference

Add attendee

Add a new participant to an existing calendar booking in Cal.com, expanding who's included in your scheduled event.

Create oauth client user

Creates a new managed user account within your Cal.com Platform OAuth application, optionally setting up a default work schedule so they can immediately start accepting bookings.

Delete OAuth Client Managed User

Removes a managed user's connection to an OAuth client application while keeping their Cal.com account intact, useful when revoking access or restructuring user integrations.

Delete selected slot

Remove a specific time slot from your Cal schedule to free up availability or correct scheduling errors. This is useful when you need to permanently delete a previously created slot.

Cancel booking via uid

Remove an existing booking from your calendar by its unique identifier, allowing you to free up time and notify attendees automatically. This is useful when appointments need to be cancelled due to scheduling conflicts, client cancellations, or no-shows.

Confirm booking by uid

Finalizes a pending booking in your calendar system, locking in the appointment details and marking it as confirmed in your schedule.

Decline booking with reason

Reject a pending booking appointment with an optional explanation, permanently removing it from your calendar. Use this when you need to turn down scheduling requests before they're confirmed.

Connect to calendar

Establishes a connection between your application and a calendar service, providing authorization details needed to access and manage calendar data. This enables your tools to read and interact with your calendar events without manual syncing.

Check calendar availability

Find available time slots on a calendar without viewing event details, allowing you to identify when you're free for meetings or tasks. This helps you coordinate schedules with clients or team members while maintaining privacy about your actual commitments.

Check ics feed calendar endpoint

Validates that an ICS calendar feed URL is working properly and contains valid calendar data before integrating it into your scheduling system.

Delete destination calendar by id

Remove a destination calendar from your Cal account to stop syncing events to that calendar or clean up outdated integrations.

Delete selected calendars

Remove one or more calendars from your active calendar view without permanently deleting them from your calendar provider. This helps you declutter your calendar workspace by hiding calendars you don't need to see regularly.

Delete conference app connection

Remove a video conferencing tool from your Cal.com account to stop integrating that service with your scheduling and meeting workflows.

Create team event type

Set up a new scheduling template for your team that defines how clients can book meetings with specific team members or groups. This lets you standardize booking details like duration, buffer time, and which calendar the event syncs to.

Create phone call event

Schedules a phone call event in your Cal.com calendar using your existing event type and team settings, allowing you to register call details without initiating the actual call.

Create phone call for event type

Sets up AI-powered phone calling for a specific event type so you can automate appointment reminders or customer follow-ups without manual dialing.

Create team event types with custom options

Set up customizable team scheduling events with specific meeting durations, booking rules, and assigned hosts to streamline how your team handles client or internal meetings.

Delete event type by id

Remove an event type from your scheduling system permanently, making it unavailable for new bookings while preserving any existing appointments.

Delete event type in team

Remove an event type from your team's scheduling options to clean up obsolete booking types or reorganize your scheduling offerings. This action permanently deletes the event type configuration and cannot be undone.

Delete team event type in organization

Permanently removes a team event type from your organization's calendar, helping you streamline your scheduling options when certain meeting types are no longer needed.

Add organization attribute option

Adds a new option to an organization's single or multi-select attribute, allowing you to expand the available choices for existing fields like departments, locations, or priority levels.

Create membership for organization

Adds an existing user to your Cal.com organization and assigns them a membership role. This lets you grant team members access to your scheduling system and collaborative features.

Create organization attributes

Add custom fields to your organization to collect specific information during event bookings or when managing user profiles, allowing you to gather data tailored to your business needs.

Delete organization attribute

Remove a custom attribute from your organization permanently, which may impact any features or workflows that depend on that attribute.

Delete organization attribute option

Permanently removes an option from your organization's attributes, such as cleaning up unused selections in dropdown or multi-select fields. This helps keep your team's configuration options organized and relevant.

Delete organization membership

Removes a user's complete access and permissions from your organization, permanently ending their membership and collaboration rights.

Delete user attribute option

Remove a specific attribute option (such as a skill, role, or department) from a user's profile without deleting the attribute itself from your organization.

Check Stripe status

Verifies that your Stripe payment processor is properly connected to Cal and ready to accept payments from your clients. This helps ensure your booking system can successfully process transactions without interruption.

Check team stripe integration status

Verify whether your team's Stripe account is properly connected and active, letting you confirm that payment processing is ready for your customers.

Create user availability schedule

Define when you're available for client meetings by setting up a recurring weekly schedule with timezone support and specific date overrides. This ensures your calendar automatically blocks out unavailable times across all your booking links.

Create user schedule in organization

Sets up a custom availability schedule for a team member in your organization, with weekly recurring time slots and the ability to override specific dates. This helps ensure client bookings and meetings only happen during times you're actually available.

Delete schedule by id

Remove a schedule from your Cal account permanently using its ID. Use this when you need to delete outdated or unused scheduling templates.

Check gcal synchronization status

Verify that your Google Calendar is properly connected and synced with your Cal account, ensuring all events are up-to-date across both platforms.

Add member to team

Adds a new member to your team in Cal, enabling them to access team calendars and scheduling features. This allows you to expand your team's scheduling capabilities and share calendar management responsibilities.

Create or update team profile

Set up or modify your team's scheduling profile with custom branding, availability settings, and privacy preferences. This helps you present a professional presence and control how clients book time with your team.

Create team in organization

Create a new team within your Cal.com organization to organize scheduling and resources across different departments or projects. This lets you manage separate calendars, availability rules, and booking preferences for different business functions.

Create team invite link

Generate a shareable invitation link that allows new team members to join your Cal.com scheduling team without manual invitations. This creates a convenient way to onboard collaborators and expand your team's capacity.

Create team membership with role

Add a user to your Cal.com team with a specific role, allowing you to control access levels and responsibilities across your scheduling platform. This helps you delegate calendar management and booking responsibilities while maintaining proper permission structures.

Delete membership in team

Permanently removes a user from a specific team, revoking their access to team-specific scheduling and resources while keeping them in the organization.

Delete team by id

Permanently removes a team and all its associated data from your Cal calendar system. Use this when you no longer need a team or want to clean up your workspace.

Delete team from organization

Permanently removes a team from your Cal.com organization, deleting all associated team data including members, event types, and bookings.

Delete team memberships by id

Remove a user's access to a specific team in Cal while keeping their account intact. This is useful when team members leave or change roles and need to be removed from collaborative scheduling.

Delete user from organization

Remove a team member's access to your organization while keeping their account intact. Use this when someone leaves your team or no longer needs calendar management permissions.

Create OAuth client webhook configuration

Set up real-time event notifications from your Cal.com calendar by configuring webhooks that automatically send booking, cancellation, and meeting data to your applications. This enables you to trigger automated workflows whenever important calendar events occur.

Create organization webhook by org ID

Set up automated notifications sent to your apps whenever specific calendar or booking events occur in your organization, enabling seamless integration with your existing business tools.

Create webhook for event type

Set up automated notifications that send calendar event updates to your apps or services whenever specific actions occur on a Cal.com event type, enabling seamless integration with your business workflow.

Delete all team event type webhooks

Removes all webhook connections tied to a team's event type, stopping any automated notifications or integrations that were triggered by booking changes for that event.

Delete oauth client webhook

Removes a webhook from your Cal.com OAuth client so it stops receiving event notifications. Use this to disable automated alerts and notifications that you no longer need.

Delete org webhook

Removes an organization-level webhook permanently, stopping all automated notifications sent to that webhook's URL. Use this when you no longer need event updates from your scheduling system sent to external applications.

Create organization team form workflow

Set up automated workflows that trigger actions like emails or notifications whenever team members submit routing forms, enabling you to streamline how form responses are processed and distributed across your organization.

Add selected calendar

Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the integration provider, the…

Assign or create attribute option for user

Assigns an existing attribute option (using attributeOptionId) or creates a new one (using value) for a user, linking it to a specified attributeId which must…

Connect conferencing app

Connects or reconnects Cal.com with a specified conferencing application to enable future virtual meeting scheduling, but does not itself create or schedule…

Create a new booking

Creates a new booking for an event type at a specified start time.

Create webhook subscription

Creates a new Cal.com webhook subscription to send real-time notifications for specified calendar events (like bookings, meetings, forms) to a publicly…

Delete user schedule

Permanently deletes a specific user's schedule, provided the organization, user, and schedule (identified by orgId, userId, and scheduleId) exist.

Delete webhook by id

Permanently deletes an existing webhook by its webhookId, stopping future notifications; this action is irreversible.

Delete webhook for event type

Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event type and…

Delete webhooks for event type

Call this to irreversibly delete all webhooks for a specific eventTypeId if the event type exists; details of deleted webhooks are not returned.

Disconnect calendar using credential id

Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal's access; external calendar data remains unaffected.

Edit attendee by ID

Tool to edit an existing attendee in a Cal.com booking.

Edit availability by ID

Tool to edit an existing availability by ID on Cal.com.

Edit booking by ID

Tool to edit an existing booking by its ID.

Edit event type by ID

Tool to edit an existing Cal.com event type by ID.

Edit selected calendar by ID

Tool to edit a selected calendar by its composite ID in Cal.com.

Fetch all bookings

Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team IDs (which must belong to/include the authenticated user…

Fetch event type details

Fetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and be…

Fetch organization attribute by id

Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record.

Fetch provider access token

Fetches an OAuth access token for the specified clientId to authenticate API calls; this action only retrieves the token, not managing scheduling or calendar…

Fetch schedule by id

Fetches comprehensive details for a specific, existing schedule using its scheduleId.

Fetch user schedule by org id

Retrieves a specific user's schedule within an organization, returning availability windows, timezone settings, and date-specific overrides.

Fetch webhook by event type id

Retrieves details for a single, specific webhook using its webhookId and associated eventTypeId.

Force refresh user oauth client

Forces an immediate refresh of OAuth tokens for a Platform managed user.

Get all timezones

Retrieves all supported time zone identifiers (e.g., 'America/NewYork', 'Europe/London') and their associated metadata, excluding specific DST changes or…

Get available slots info

Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type.

Get booking reference by id

Tool to find a specific booking reference by its ID.

Get booking references

Retrieves external references for a specific booking within an organization's team.

Get conference OAuth authorization url

Generates an OAuth 2.0 authorization URL for a supported conferencing app to initiate or refresh its integration with Cal.com.

Get default schedule details

Retrieves the Cal system's global default schedule configuration, not custom or user-specific ones.

Get destination calendars

Tool to retrieve all destination calendars configured for the authenticated user.

Get event type by team id

Retrieves a specific event type by its ID, requiring that the event type is associated with the given team ID.

Get event type private links

Retrieves all private booking links for a specific event type.

Get google calendar oauth authentication url

Generates the initial Google Calendar OAuth 2.0 authorization URL for user redirection to begin the authentication and authorization process.

Get oauth clients user

Retrieves all managed users associated with a Platform OAuth client.

Get organization attribute assigned options

Retrieves all assigned attribute options for a specific attribute within an organization.

Get organization attribute assigned options by slug

Tool to retrieve all assigned attribute options for a specific attribute by its slug within an organization.

Get organization ID

Retrieves the organization ID associated with the currently authenticated user from the Cal.com /v2/me endpoint.

Get organization schedules

Retrieves availability schedules for an organization.

Get organization team workflows

Retrieves workflows configured for a specific team within an organization.

Get organization teams event types

Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by orgId.

Get organization user schedules

Retrieves all availability schedules configured for a specific user within an organization.

Get private links for team event type

Get all private links for a team event type.

Get schedule for user in team

Retrieves all availability schedules for a specific user within a team and organization.

Get selected calendar by ID

Tool to retrieve a selected calendar by its compound ID (userIdintegrationexternalId).

Get stripe connect info

Retrieves Stripe Connect account details (ID, charges/payouts status, verification, settings) for the user's linked Cal.com account; response may be empty or…

Get Stripe Connect URL for team

Tool to get Stripe Connect authorization URL for a team within an organization.

Get team bookings

Retrieves all bookings for a specified team, optionally filtered by status, attendee details, date ranges, or event type IDs, with support for pagination and…

Get team default conferencing app

Retrieves the default conferencing application configured for a specific team within an organization.

Get team details by organization ID and team ID

Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and…

Get team event type webhook

Retrieves details for a specific webhook configured on a team event type.

Get team event type webhooks

Retrieves all webhooks configured for a specific team event type.

Get team information by team ID

Retrieves detailed information about a specific Cal.com team by its ID.

Get team routing forms

Retrieves routing forms for a specific team within an organization.

Get team schedules

Retrieves availability schedules for all members of a specific team within an organization.

Get teams list

Retrieves all teams the user belongs to, including their names and members.

Get verified phone numbers

Retrieves a paginated list of verified phone numbers for a specific organization team.

Get webhook by id

Retrieves details for an existing and accessible webhook by its ID; this is a read-only operation.

Handle conferencing oauth callback for app

Processes an OAuth 2.0 callback for a conferencing app, exchanging the code and state for access credentials; ensure an OAuth flow was previously initiated.

List all attendees

Tool to retrieve all attendees from Cal.com.

List booking references

Fetches one page of booking references in Cal.com.

List event types

Retrieves Cal event types, filterable by username (required if eventSlug is provided), multiple usernames, or organization details (orgSlug or orgId).

List organization memberships

Retrieves all memberships for a given organization, including user details, roles, status, and membership dates.

List team event types by org and team id

Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug.

Mark booking absent for UID

Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows.

Modify org attribute by id

Partially updates an organization attribute using orgId and attributeId, allowing modification of its name, slug, type, or enabled status; changing the 'type'…

Modify organization membership by id

Updates an organization membership's status (accepted), role, or impersonation settings, identified by orgId and membershipId in the path; requires at least…

Patch organization attribute option

Partially updates a specific option for an organization's attribute, modifying its 'value' and/or 'slug'; at least one of 'value' or 'slug' must be provided.

Patch organization user details

Partially updates details for a user that exists within the specified organization.

Patch team details by ID

Updates specified details for an existing team identified by teamId; unspecified fields remain unchanged.

Patch webhook event type

Updates configuration (e.g., payload template, active status, URL, triggers, secret) for an existing webhook tied to a specific event type.

Post calendar credentials

Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar services…

Post user to organization

Adds a new user to an existing organization (identified by orgId in path), requiring user's email and allowing extensive optional profile customization.

Reassign booking to another user

Reassigns an existing booking to a specified user.

Reassign booking with uid

Reassigns the specified booking to a new team member, who is determined by the system rather than being specified in the request.

Refresh oauth token for client id

Refreshes an OAuth access token for a specified clientId and managed user using their refreshToken.

Request email verification code

Request an email verification code for a team's verified resources.

Reschedule booking by uid

Reschedules an existing booking (identified by bookingUid) to a new time.

Reserve slot for event

Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while the user…

Retrieve attribute options for org

Retrieves all available options for a specific attribute within an organization.

Retrieve booking details by uid

Fetches comprehensive details for an existing booking, identified by its bookingUid.

Retrieve calendar busy times

To find busy calendar slots for scheduling/conflict detection, call this with a valid credentialId, an externalId accessible by it, and a recognized IANA…

Retrieve calendar list

Retrieves a list of all calendar summaries (no event details) associated with the authenticated user's account.

Retrieve current team for organization

Retrieves details of the team(s) for the currently authenticated user within the specified organization orgId.

Retrieve default conferencing settings

Retrieves an account's or organization's read-only default conferencing settings in Cal.com (e.g., video platform, meeting duration) to inform event creation…

Retrieve event type by id

Retrieves comprehensive details for a specific, existing Cal.com event type using its unique ID; this is a read-only action and does not return associated…

Retrieve membership from organization

Retrieves detailed information about a specific membership within a particular organization.

Retrieve my information

Retrieves the authenticated user's core profile information (e.g., name, email, timezone); does not retrieve related data like calendar events or schedules.

Retrieve OAuth client user by ID

Retrieves detailed profile information for a specific managed user associated with an OAuth client.

Retrieve oauth client webhook by id

Retrieves detailed configuration for a specific webhook by ID from a Platform OAuth client.

Retrieve organization attributes

Retrieves detailed attributes (e.g., configurations, settings, metadata) for an organization, identified by its orgId, which must correspond to an existing…

Retrieve organization attributes options

Retrieves all attribute options assigned to a specific user within an organization.

Retrieve organization webhook by id

Retrieves detailed information, including configuration and status, for a specific webhook by its ID (webhookId) within a given organization (orgId).

Retrieve organization webhooks by org ID

Retrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers, subscriber…

Retrieve provider details

Verifies and retrieves details for an OAuth client (provider) in Cal.com's Platform API.

Retrieve schedules list

Retrieve all availability schedules for the authenticated Cal.com user.

Retrieve team details in organization

Retrieves a paginated list of teams and their details for a specific organization ID; individual team member details or schedules are not included.

Retrieve team event types

Retrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability.

Retrieve team membership by id

Retrieves detailed information for a specific team membership by its ID within an organization's team.

Retrieve team membership details

Retrieves detailed attributes for a specific team membership by its ID and the team ID, such as member information, role, and status; does not list all team…

Retrieve team memberships

Retrieves all memberships for a team, including member details, roles (MEMBER/OWNER/ADMIN), and invitation acceptance status.

Retrieve team memberships for organization

Retrieves all user memberships for a specific team within an organization, including each member's role (OWNER, ADMIN, MEMBER), acceptance status,…

Retrieve users in organization

Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data; the orgId must be a valid identifier for an…

Retrieve v2 conferencing info

Retrieves an authenticated Cal user's or organization's video conferencing configurations, capabilities, and installed apps, useful for understanding options…

Retrieve webhook details for OAuth client

Retrieves all webhook configurations for a specific OAuth client with optional pagination.

Retrieve webhooks for event type

Retrieves a paginated list of webhooks (including URLs, subscribed events, and status) for a specified, existing event type ID, useful for auditing…

Retrieve webhooks list

Retrieves a paginated list of webhooks from the user's Cal scheduling system account, which are used for real-time notifications on events like new bookings,…

Save calendar entry

Saves or updates a calendar's settings using a GET request, typically for data already on the server or simple updates via query parameters.

Save calendar ics feeds

Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.com calendar system.

Save OAuth credentials via GCal API

Completes the Google Calendar OAuth 2.0 flow by exchanging the code and state (received from Google's redirect after user consent) for access and refresh…

Save stripe details

Completes the Stripe OAuth flow by saving Stripe details; call this when a user is redirected back from Stripe with an authorization code and state.

Set default conferencing app

Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user.

Update destination calendar integration

Updates the destination calendar for syncing events, using integration and externalId (typically from /calendars endpoint).

Update OAuth client user settings

Updates specified profile and scheduling preference fields for a user associated with an OAuth client; defaultScheduleId, if provided, must be an existing,…

Update oauth client webhook

Updates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged.

Update private link

Updates a private link for a team event type within an organization.

Update schedule by ID

Updates an existing schedule by its ID, allowing partial modification of properties; providing availability or overrides replaces them entirely.

Update team event type

Tool to update a team event type in Cal.com.

Update team event type webhook

Updates a webhook for a team event type.

Update team information by id

Updates an existing team's information by its ID within a specified organization; the slug, if provided, must be unique within the organization.

Update team membership by id

Updates properties of an existing team membership.

Update team membership properties

Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization.

Update user profile details

Updates the profile information and preferences for the authenticated user, affecting only the fields provided in the request.

Update user schedule in organization

Modifies an existing schedule for a specified user within an organization by updating only the provided fields; the organization, user, and schedule must…

Update webhook by id

Updates an existing Cal.com webhook by its webhookId, allowing partial modification of its attributes; only explicitly provided fields will be changed.

Update webhook for organization

Updates an existing webhook for an organization.