Cal.com

Connect Cal.com so your agents can work in your Cal.com account.

Access levels

Cal.com has one level. The connect window shows it as Default and describes it as “Standard access.” Agents can use all 175 Cal.com actions. You cannot choose a narrower level for Cal.com. You can block single agents with No access under Per-agent access. The Cal.com sign-in page asks you to approve full access to your account. This is expected. Squad does not narrow the sign-in, and standard access does not limit which Cal.com actions agents can use.

What agents can do

The summary below groups the Cal.com actions into plain tasks. The full list after it names every action, grouped by what the action works on. You do not need to name actions. Ask in plain words, and the agent searches for the matching action.

Find an action. Open the list and use your browser’s find (Ctrl+F, or Cmd+F on a Mac) with a word from the task or part of a slug. Or ask your agent in plain words, for example “What can you do in my Cal.com account?” The agent can search the Cal.com actions for you.

Each action shows its name, a one-line description where the Cal.com action catalog has one, and its slug. The slug is the ID that agents use when they call the action.

View, create, update, and delete webhooks
View, create, update, and delete types
View, create, update, and delete members
View, create, update, and delete schedules
View, create, update, and delete settings
View, update, and cancel bookings
View, create, update, and delete teams
View, create, update, and delete users
View, create, update, and delete calendars
View, create, update, and delete attributes
View, update, delete, and manage availability
View, create, and update links

All 175 Cal.com actions

Apps (4)

Action	What it does	Slug
Get team default conferencing app	Retrieves the default conferencing application configured for a specific team within an organization.	`CAL_GET_TEAM_DEFAULT_CONFERENCING_APP`
Handle conferencing OAuth callback for app	Processes an OAuth 2.0 callback for a conferencing app, exchanging the code and state for access credentials.	`CAL_HANDLE_CONFERENCING_OAUTH_CALLBACK_FOR_APP`
Post conferencing app connect	Connects or reconnects Cal.com with a specified conferencing application to enable future virtual meeting scheduling, but does not itself create or schedule meetings.	`CAL_POST_CONFERENCING_APP_CONNECT`
Set default conferencing app	Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user.	`CAL_SET_DEFAULT_CONFERENCING_APP`

Attendees (3)

Action	What it does	Slug
Add attendee	Create a new attendee for an existing booking in Cal.com.	`CAL_ADD_ATTENDEE`
Edit attendee by ID	Edit an existing attendee in a Cal.com booking.	`CAL_EDIT_ATTENDEE_BY_ID`
List attendees	Retrieve all attendees from Cal.com.	`CAL_LIST_ATTENDEES`

Attributes (5)

Action	What it does	Slug
Create organization attributes	Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles.	`CAL_CREATE_ORGANIZATION_ATTRIBUTES`
Delete organization attribute	Permanently deletes an existing attribute (specified by attributeId) from an existing organization (specified by orgId).	`CAL_DELETE_ORGANIZATION_ATTRIBUTE`
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.	`CAL_FETCH_ORGANIZATION_ATTRIBUTE_BY_ID`
Modify org attribute by ID	Partially updates an organization attribute using orgId and attributeId, allowing modification of its name, slug, type, or enabled status.	`CAL_MODIFY_ORG_ATTRIBUTE_BY_ID`
Retrieve organization attributes	Retrieves detailed attributes (e.g., configurations, settings, metadata) for an organization, identified by its orgId, which must correspond to an existing organization.	`CAL_RETRIEVE_ORGANIZATION_ATTRIBUTES`

Availability (4)

Action	What it does	Slug
Delete selected slot	Deletes a previously selected time slot from the Cal schedule using its uid.	`CAL_DELETE_SELECTED_SLOT`
Edit availability by ID	Edit an existing availability by ID on Cal.com.	`CAL_EDIT_AVAILABILITY_BY_ID`
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.	`CAL_GET_AVAILABLE_SLOTS_INFO`
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 completes the booking.	`CAL_RESERVE_SLOT_FOR_EVENT`

Bookings (15)

Action	What it does	Slug
Cancel booking via uid	Cancels an existing and active Cal.com booking using its unique identifier (UID).	`CAL_CANCEL_BOOKING_VIA_UID`
Confirm booking by uid	Confirms an existing booking by bookingUid if the booking exists and is in a state allowing confirmation (e.g., not already cancelled or confirmed).	`CAL_CONFIRM_BOOKING_BY_UID`
Decline booking with reason	Declines a pending booking using its bookingUid, optionally with a reason.	`CAL_DECLINE_BOOKING_WITH_REASON`
Edit booking by ID	Edit an existing booking by its ID.	`CAL_EDIT_BOOKING_BY_ID`
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 respectively), with support for pagination and sorting.	`CAL_FETCH_ALL_BOOKINGS`
Get booking reference by ID	Find a specific booking reference by its ID.	`CAL_GET_BOOKING_REFERENCE_BY_ID`
Get booking references	Retrieves external references for a specific booking within an organization’s team.	`CAL_GET_BOOKING_REFERENCES`
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 sorting.	`CAL_GET_TEAM_BOOKINGS`
List booking references	Fetches one page of booking references in Cal.com.	`CAL_LIST_BOOKING_REFERENCES`
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.	`CAL_MARK_BOOKING_ABSENT_FOR_UID`
Post new booking request	Creates a new booking for an event type at a specified start time.	`CAL_POST_NEW_BOOKING_REQUEST`
Reassign booking to another user	Reassigns an existing booking to a specified user.	`CAL_REASSIGN_BOOKING_TO_ANOTHER_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.	`CAL_REASSIGN_BOOKING_WITH_UID`
Reschedule booking by uid	Reschedules an existing booking (identified by bookingUid) to a new time.	`CAL_RESCHEDULE_BOOKING_BY_UID`
Retrieve booking details by uid	Fetches comprehensive details for an existing booking, identified by its bookingUid.	`CAL_RETRIEVE_BOOKING_DETAILS_BY_UID`

Calendars (13)

Action	What it does	Slug
Check ICS feed calendar endpoint	Checks an ICS feed URL (expected as a query parameter) to verify its validity, accessibility, and iCalendar data integrity.	`CAL_CHECK_ICS_FEED_CALENDAR_ENDPOINT`
Connect to calendar	Initiates or checks the external connection status for a specified calendar, possibly returning a redirect URL for user authorization to complete integration, without altering calendar data.	`CAL_CONNECT_TO_CALENDAR`
Delete destination calendar by ID	Remove an existing destination calendar by its unique ID.	`CAL_DELETE_DESTINATION_CALENDAR_BY_ID`
Delete selected calendars	Removes a specified, currently selected calendar from the user’s active list within the application, without deleting it from the external provider.	`CAL_DELETE_SELECTED_CALENDARS`
Disconnect calendar using credential ID	Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal’s access.	`CAL_DISCONNECT_CALENDAR_USING_CREDENTIAL_ID`
Edit selected calendar by ID	Edit a selected calendar by its composite ID in Cal.com.	`CAL_EDIT_SELECTED_CALENDAR_BY_ID`
Get destination calendars	Retrieve all destination calendars configured for the authenticated user.	`CAL_GET_DESTINATION_CALENDARS`
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.	`CAL_GET_GOOGLE_CALENDAR_OAUTH_AUTHENTICATION_URL`
Get selected calendar by ID	Retrieve a selected calendar by its compound ID (userId_integration_externalId).	`CAL_GET_SELECTED_CALENDAR_BY_ID`
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 for synchronization.	`CAL_POST_CALENDAR_CREDENTIALS`
Post selected calendars	Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the integration provider, the calendar’s externalId, and the credentialId.	`CAL_POST_SELECTED_CALENDARS`
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 loggedInUsersTz.	`CAL_RETRIEVE_CALENDAR_BUSY_TIMES`
Save calendar ICS feeds	Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.com calendar system.	`CAL_SAVE_CALENDAR_ICS_FEEDS`

Calls (1)

Action	What it does	Slug
Create phone call for event type	Configures Cal.ai phone call automation for a team event type, enabling AI-powered outbound calls for appointment reminders or custom conversations.	`CAL_CREATE_PHONE_CALL_FOR_EVENT_TYPE`

Clients (1)

Action	What it does	Slug
Force refresh user OAuth client	Forces an immediate refresh of OAuth tokens for a Platform managed user.	`CAL_FORCE_REFRESH_USER_OAUTH_CLIENT`

Code (1)

Action	What it does	Slug
Request email verification code	Request an email verification code for a team’s verified resources.	`CAL_REQUEST_EMAIL_VERIFICATION_CODE`

Connections (1)

Action	What it does	Slug
Delete conference app connection	Disconnects the specified conferencing application (e.g., ‘zoom’, ‘google_meet’) for the Cal.com account, immediately terminating any ongoing call or meeting.	`CAL_DELETE_CONFERENCE_APP_CONNECTION`

Entries (1)

Action	What it does	Slug
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.	`CAL_SAVE_CALENDAR_ENTRY`

Events (2)

Action	What it does	Slug
Create phone call event	Schedules a phone call event in Cal.com using existing eventType, organization, and team IDs.	`CAL_CREATE_PHONE_CALL_EVENT`
Post webhook event	Creates a new Cal.com webhook subscription to send real-time notifications for specified calendar events (like bookings, meetings, forms) to a publicly accessible subscriber URL.	`CAL_POST_WEBHOOK_EVENT`

Forms (1)

Action	What it does	Slug
Get team routing forms	Retrieves routing forms for a specific team within an organization.	`CAL_GET_TEAM_ROUTING_FORMS`

Integrations (2)

Action	What it does	Slug
Check team Stripe integration status	Retrieves the Stripe integration status and related information for a team, primarily to verify account connection, subscription details, or payment setup.	`CAL_CHECK_TEAM_STRIPE_INTEGRATION_STATUS`
Update destination calendar integration	Updates the destination calendar for syncing events, using integration and externalId (typically from /calendars endpoint).	`CAL_UPDATE_DESTINATION_CALENDAR_INTEGRATION`

Links (4)

Action	What it does	Slug
Create team invite link	Creates a shareable invite link for a Cal.com team that allows new members to join.	`CAL_CREATE_TEAM_INVITE_LINK`
Get event type private links	Retrieves all private booking links for a specific event type.	`CAL_GET_EVENT_TYPE_PRIVATE_LINKS`
Get private links	Get all private links for a team event type.	`CAL_GET_PRIVATE_LINKS`
Update private link	Updates a private link for a team event type within an organization.	`CAL_UPDATE_PRIVATE_LINK`

Lists (4)

Action	What it does	Slug
Get teams list	Retrieves all teams the user belongs to, including their names and members.	`CAL_GET_TEAMS_LIST`
Retrieve calendar list	Retrieves a list of all calendar summaries (no event details) associated with the authenticated user’s account.	`CAL_RETRIEVE_CALENDAR_LIST`
Retrieve schedules list	Retrieve all availability schedules for the authenticated Cal.com user.	`CAL_RETRIEVE_SCHEDULES_LIST`
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, cancellations, or updates.	`CAL_RETRIEVE_WEBHOOKS_LIST`

Members (14)

Action	What it does	Slug
Add member to team using org and team ID	Adds a new member to a specified team within an organization by creating a team membership.	`CAL_ADD_MEMBER_TO_TEAM_USING_ORG_AND_TEAM_ID`
Create membership for organization	Creates a new membership for a user within a Cal.com organization.	`CAL_CREATE_MEMBERSHIP_FOR_ORGANIZATION`
Create team membership with role	Adds a user to a team with a specified role, acceptance status, and impersonation settings.	`CAL_CREATE_TEAM_MEMBERSHIP_WITH_ROLE`
Delete membership in team	Use to permanently remove a user’s membership from a specific team within an organization, which revokes their team-associated access but does not remove them from the organization.	`CAL_DELETE_MEMBERSHIP_IN_TEAM`
Delete organization membership	Irreversibly deletes a user’s membership from an organization, removing all associated access and permissions.	`CAL_DELETE_ORGANIZATION_MEMBERSHIP`
Delete team memberships by ID	Irreversibly removes a user’s team membership in the Cal application, revoking access to that specific team.	`CAL_DELETE_TEAM_MEMBERSHIPS_BY_ID`
List organization memberships	Retrieves all memberships for a given organization, including user details, roles, status, and membership dates.	`CAL_LIST_ORGANIZATION_MEMBERSHIPS`
Modify organization membership by ID	Updates an organization membership’s status (accepted), role, or impersonation settings, identified by orgId and membershipId in the path.	`CAL_MODIFY_ORGANIZATION_MEMBERSHIP_BY_ID`
Retrieve membership from organization	Retrieves detailed information about a specific membership within a particular organization.	`CAL_RETRIEVE_MEMBERSHIP_FROM_ORGANIZATION`
Retrieve team membership by ID	Retrieves detailed information for a specific team membership by its ID within an organization’s team.	`CAL_RETRIEVE_TEAM_MEMBERSHIP_BY_ID`
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.	`CAL_RETRIEVE_TEAM_MEMBERSHIP_DETAILS`
Retrieve team memberships	Retrieves all memberships for a team, including member details, roles (MEMBER/OWNER/ADMIN), and invitation acceptance status.	`CAL_RETRIEVE_TEAM_MEMBERSHIPS`
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, impersonation settings, and detailed user information (email, username, name, avatar, bio).	`CAL_RETRIEVE_TEAM_MEMBERSHIPS_FOR_ORGANIZATION`
Update team membership by ID	Updates properties of an existing team membership.	`CAL_UPDATE_TEAM_MEMBERSHIP_BY_ID`

Organizations (1)

Action	What it does	Slug
Get organization ID	Retrieves the organization ID associated with the currently authenticated user from the Cal.com /v2/me endpoint.	`CAL_GET_ORGANIZATION_ID`

Profiles (2)

Action	What it does	Slug
Create or update team profile	Creates a new team profile, or updates one if a ‘slug’ matches, customizing branding, scheduling, privacy, and operational details.	`CAL_CREATE_OR_UPDATE_TEAM_PROFILE`
Update user profile details	Updates the profile information and preferences for the authenticated user, affecting only the fields provided in the request.	`CAL_UPDATE_USER_PROFILE_DETAILS`

Properties (1)

Action	What it does	Slug
Update team membership properties	Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization.	`CAL_UPDATE_TEAM_MEMBERSHIP_PROPERTIES`

Schedules (13)

Action	What it does	Slug
Create user availability schedule	Creates a Cal.com user availability schedule, defining its name, timezone, weekly recurring availability, and specific date overrides.	`CAL_CREATE_USER_AVAILABILITY_SCHEDULE`
Create user schedule in organization	Creates a new schedule defining a user’s availability with weekly slots and date-specific overrides in an organization.	`CAL_CREATE_USER_SCHEDULE_IN_ORGANIZATION`
Delete schedule by ID	Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule.	`CAL_DELETE_SCHEDULE_BY_ID`
Delete user schedule	Permanently deletes a specific user’s schedule, provided the organization, user, and schedule (identified by orgId, userId, and scheduleId) exist.	`CAL_DELETE_USER_SCHEDULE`
Fetch schedule by ID	Fetches comprehensive details for a specific, existing schedule using its scheduleId.	`CAL_FETCH_SCHEDULE_BY_ID`
Fetch user schedule by org ID	Retrieves a specific user’s schedule within an organization, returning availability windows, timezone settings, and date-specific overrides.	`CAL_FETCH_USER_SCHEDULE_BY_ORG_ID`
Get default schedule details	Retrieves the Cal system’s global default schedule configuration, not custom or user-specific ones.	`CAL_GET_DEFAULT_SCHEDULE_DETAILS`
Get organization schedules	Retrieves availability schedules for an organization.	`CAL_GET_ORGANIZATION_SCHEDULES`
Get organization user schedules	Retrieves all availability schedules configured for a specific user within an organization.	`CAL_GET_ORGANIZATION_USER_SCHEDULES`
Get schedule for user in team	Retrieves all availability schedules for a specific user within a team and organization.	`CAL_GET_SCHEDULE_FOR_USER_IN_TEAM`
Get team schedules	Retrieves availability schedules for all members of a specific team within an organization.	`CAL_GET_TEAM_SCHEDULES`
Update schedule by ID	Updates an existing schedule by its ID, allowing partial modification of properties.	`CAL_UPDATE_SCHEDULE_BY_ID`
Update user schedule in organization	Modifies an existing schedule for a specified user within an organization by updating only the provided fields.	`CAL_UPDATE_USER_SCHEDULE_IN_ORGANIZATION`

Settings (12)

Action	What it does	Slug
Add organization attribute option	Adds a new option to an organization’s SINGLE_SELECT or MULTI_SELECT attribute.	`CAL_ADD_ORGANIZATION_ATTRIBUTE_OPTION`
Create OAuth client webhook configuration	Creates a webhook configuration for an OAuth client to receive real-time event notifications from Cal.com.	`CAL_CREATE_OAUTH_CLIENT_WEBHOOK_CONFIGURATION`
Delete organization attribute option	Permanently deletes a specified option from an organization’s attribute.	`CAL_DELETE_ORGANIZATION_ATTRIBUTE_OPTION`
Delete user attribute option	Unassigns a specific attribute option from a user within an organization.	`CAL_DELETE_USER_ATTRIBUTE_OPTION`
Get organization attribute assigned options	Retrieves all assigned attribute options for a specific attribute within an organization.	`CAL_GET_ORGANIZATION_ATTRIBUTE_ASSIGNED_OPTIONS`
Get organization attribute assigned options by slug	Retrieve all assigned attribute options for a specific attribute by its slug within an organization.	`CAL_GET_ORGANIZATION_ATTRIBUTE_ASSIGNED_OPTIONS_BY_SLUG`
Patch organization attribute option	Partially updates a specific option for an organization’s attribute, modifying its ‘value’ and/or ‘slug’.	`CAL_PATCH_ORGANIZATION_ATTRIBUTE_OPTION`
Post org attribute option by 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 already exist within the organization.	`CAL_POST_ORG_ATTRIBUTE_OPTION_BY_USER`
Retrieve attribute options for org	Retrieves all available options for a specific attribute within an organization.	`CAL_RETRIEVE_ATTRIBUTE_OPTIONS_FOR_ORG`
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 or ensure consistency.	`CAL_RETRIEVE_DEFAULT_CONFERENCING_SETTINGS`
Retrieve organization attributes options	Retrieves all attribute options assigned to a specific user within an organization.	`CAL_RETRIEVE_ORGANIZATION_ATTRIBUTES_OPTIONS`
Update OAuth client user settings	Updates specified profile and scheduling preference fields for a user associated with an OAuth client.	`CAL_UPDATE_OAUTH_CLIENT_USER_SETTINGS`

Teams (9)

Action	What it does	Slug
Create team in organization	Creates a new team with customizable attributes within an existing and accessible Cal.com organization specified by orgId.	`CAL_CREATE_TEAM_IN_ORGANIZATION`
Delete team by ID	Permanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team’s unique teamId.	`CAL_DELETE_TEAM_BY_ID`
Delete team from organization	Permanently and irreversibly deletes a specific team from a Cal.com organization.	`CAL_DELETE_TEAM_FROM_ORGANIZATION`
Get team details by org ID and team ID	Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and timezone/week preferences.	`CAL_GET_TEAM_DETAILS_BY_ORG_ID_AND_TEAM_ID`
Get team information by team ID	Retrieves detailed information about a specific Cal.com team by its ID.	`CAL_GET_TEAM_INFORMATION_BY_TEAM_ID`
Patch team details by ID	Updates specified details for an existing team identified by teamId.	`CAL_PATCH_TEAM_DETAILS_BY_ID`
Retrieve current team for organization	Retrieves details of the team(s) for the currently authenticated user within the specified organization orgId.	`CAL_RETRIEVE_CURRENT_TEAM_FOR_ORGANIZATION`
Retrieve team details in organization	Retrieves a paginated list of teams and their details for a specific organization ID.	`CAL_RETRIEVE_TEAM_DETAILS_IN_ORGANIZATION`
Update team information by ID	Updates an existing team’s information by its ID within a specified organization.	`CAL_UPDATE_TEAM_INFORMATION_BY_ID`

Time zones (1)

Action	What it does	Slug
Get all timezones	Retrieves all supported time zone identifiers (e.g., ‘America/New_York’, ‘Europe/London’) and their associated metadata, excluding specific DST changes or precise UTC offset details.	`CAL_GET_ALL_TIMEZONES`

Tokens (2)

Action	What it does	Slug
Fetch provider access token	Fetches an OAuth access token for the specified clientId to authenticate API calls.	`CAL_FETCH_PROVIDER_ACCESS_TOKEN`
Refresh OAuth token for client ID	Refreshes an OAuth access token for a specified clientId and managed user using their refreshToken.	`CAL_REFRESH_OAUTH_TOKEN_FOR_CLIENT_ID`

Types (15)

Action	What it does	Slug
Create team event type	Creates a new event type for a specified team in Cal.com.	`CAL_CREATE_TEAM_EVENT_TYPE`
Create team event types with custom options	Creates a highly customizable Cal.com team event type with extensive scheduling, booking, and host assignment options.	`CAL_CREATE_TEAM_EVENT_TYPES_WITH_CUSTOM_OPTIONS`
Delete event type by ID	Permanently deletes an existing event type by its ID, which invalidates its scheduling links.	`CAL_DELETE_EVENT_TYPE_BY_ID`
Delete event type in team	Permanently removes an event type’s configuration from a team’s scheduling options (e.g., for cleanup).	`CAL_DELETE_EVENT_TYPE_IN_TEAM`
Delete team event type in organization	Permanently removes a team event type from an organization’s scheduling configuration.	`CAL_DELETE_TEAM_EVENT_TYPE_IN_ORGANIZATION`
Edit event type by ID	Edit an existing Cal.com event type by ID.	`CAL_EDIT_EVENT_TYPE_BY_ID`
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 accessible.	`CAL_FETCH_EVENT_TYPE_DETAILS`
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.	`CAL_GET_EVENT_TYPE_BY_TEAM_ID`
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.	`CAL_GET_ORGANIZATION_TEAMS_EVENT_TYPES`
List event types	Retrieves Cal event types, filterable by username (required if eventSlug is provided), multiple usernames, or organization details (orgSlug or orgId).	`CAL_LIST_EVENT_TYPES`
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.	`CAL_LIST_TEAM_EVENT_TYPES_BY_ORG_AND_TEAM_ID`
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.	`CAL_PATCH_WEBHOOK_EVENT_TYPE`
Retrieve event type by ID	Retrieves comprehensive details for a specific, existing Cal.com event type using its unique ID.	`CAL_RETRIEVE_EVENT_TYPE_BY_ID`
Retrieve team event types	Retrieves event types for a team within the Cal scheduling system.	`CAL_RETRIEVE_TEAM_EVENT_TYPES`
Update team event type	Update a team event type in Cal.com.	`CAL_UPDATE_TEAM_EVENT_TYPE`

Users (8)

Action	What it does	Slug
Create OAuth client user	Creates a new managed user for a Cal.com Platform OAuth client.	`CAL_CREATE_OAUTH_CLIENT_USER`
Delete OAuth client user	Permanently removes a managed user’s association with an OAuth client without deleting their Cal.com account.	`CAL_DELETE_OAUTH_CLIENT_USER`
Delete user from organization	Permanently removes a user from a specific organization (user’s system-wide account is unaffected), revoking their access rights therein.	`CAL_DELETE_USER_FROM_ORGANIZATION`
Get OAuth clients user	Retrieves all managed users associated with a Platform OAuth client.	`CAL_GET_OAUTH_CLIENTS_USER`
Patch organization user details	Partially updates details for a user that exists within the specified organization.	`CAL_PATCH_ORGANIZATION_USER_DETAILS`
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.	`CAL_POST_USER_TO_ORGANIZATION`
Retrieve OAuth client user by ID	Retrieves detailed profile information for a specific managed user associated with an OAuth client.	`CAL_RETRIEVE_OAUTH_CLIENT_USER_BY_ID`
Retrieve users in organization	Retrieves users associated with a specific organization ID, excluding individual scheduling or calendar data.	`CAL_RETRIEVE_USERS_IN_ORGANIZATION`

Versions (1)

Action	What it does	Slug
Check calendar version2	Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details.	`CAL_CHECK_CALENDAR_VERSION2`

Webhooks (21)

Action	What it does	Slug
Create organization webhook by org ID	Creates a webhook for an organization that sends HTTP POST notifications to a specified URL when triggered by events (e.g., booking created, cancelled, meeting started).	`CAL_CREATE_ORGANIZATION_WEBHOOK_BY_ORG_ID`
Create webhook for event type	Creates a webhook for an existing eventTypeId in Cal.com, sending notifications for specified triggers to a subscriberUrl that handles POST requests.	`CAL_CREATE_WEBHOOK_FOR_EVENT_TYPE`
Delete all team event type webhooks	Permanently deletes all webhooks associated with a specific team event type.	`CAL_DELETE_ALL_TEAM_EVENT_TYPE_WEBHOOKS`
Delete OAuth client webhook	Permanently deletes a specific webhook for an OAuth client in Cal.com Platform API.	`CAL_DELETE_OAUTH_CLIENT_WEBHOOK`
Delete org webhook	Permanently deletes an organization-level webhook by its ID.	`CAL_DELETE_ORG_WEBHOOK`
Delete webhook by ID	Permanently deletes an existing webhook by its webhookId, stopping future notifications.	`CAL_DELETE_WEBHOOK_BY_ID`
Delete webhook for event type	Permanently deletes a specific webhook for an event type, halting its real-time notifications.	`CAL_DELETE_WEBHOOK_FOR_EVENT_TYPE`
Delete webhooks for event type	Irreversibly delete all webhooks for a specific eventTypeId if the event type exists.	`CAL_DELETE_WEBHOOKS_FOR_EVENT_TYPE`
Fetch webhook by event type ID	Retrieves details for a single, specific webhook using its webhookId and associated eventTypeId.	`CAL_FETCH_WEBHOOK_BY_EVENT_TYPE_ID`
Get team event type webhook	Retrieves details for a specific webhook configured on a team event type.	`CAL_GET_TEAM_EVENT_TYPE_WEBHOOK`
Get team event type webhooks	Retrieves all webhooks configured for a specific team event type.	`CAL_GET_TEAM_EVENT_TYPE_WEBHOOKS`
Get webhook by ID	Retrieves details for an existing and accessible webhook by its ID.	`CAL_GET_WEBHOOK_BY_ID`
Retrieve OAuth client webhook by ID	Retrieves detailed configuration for a specific webhook by ID from a Platform OAuth client.	`CAL_RETRIEVE_OAUTH_CLIENT_WEBHOOK_BY_ID`
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).	`CAL_RETRIEVE_ORGANIZATION_WEBHOOK_BY_ID`
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 URL, active status, etc.).	`CAL_RETRIEVE_ORGANIZATION_WEBHOOKS_BY_ORG_ID`
Retrieve webhook details for OAuth client	Retrieves all webhook configurations for a specific OAuth client with optional pagination.	`CAL_RETRIEVE_WEBHOOK_DETAILS_FOR_OAUTH_CLIENT`
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 configurations or troubleshooting.	`CAL_RETRIEVE_WEBHOOKS_FOR_EVENT_TYPE`
Update OAuth client webhook	Updates specified properties of an existing webhook for an OAuth client.	`CAL_UPDATE_OAUTH_CLIENT_WEBHOOK`
Update team event type webhook	Updates a webhook for a team event type.	`CAL_UPDATE_TEAM_EVENT_TYPE_WEBHOOK`
Update webhook by ID	Updates an existing Cal.com webhook by its webhookId, allowing partial modification of its attributes.	`CAL_UPDATE_WEBHOOK_BY_ID`
Update webhook for organization	Updates an existing webhook for an organization.	`CAL_UPDATE_WEBHOOK_FOR_ORGANIZATION`

Workflows (2)

Action	What it does	Slug
Create organization team form workflow	Create a new workflow for routing forms within an organization team.	`CAL_CREATE_ORGANIZATION_TEAM_FORM_WORKFLOW`
Get organization team workflows	Retrieves workflows configured for a specific team within an organization.	`CAL_GET_ORGANIZATION_TEAM_WORKFLOWS`

Other actions (11)

Action	What it does	Slug
Check gcal synchronization status	Verify the connection and synchronization status of a user’s Google Calendar integration with Cal.	`CAL_CHECK_GCAL_SYNCHRONIZATION_STATUS`
Check Stripe status	Verifies if Stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration’s status.	`CAL_CHECK_STRIPE_STATUS`
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.	`CAL_GET_CONFERENCE_OAUTH_AUTHORIZATION_URL`
Get Stripe connect info	Retrieves Stripe Connect account details (ID, charges/payouts status, verification, settings) for the user’s linked Cal.com account.	`CAL_GET_STRIPE_CONNECT_INFO`
Get Stripe connect URL	Get Stripe Connect authorization URL for a team within an organization.	`CAL_GET_STRIPE_CONNECT_URL`
Get verified phone numbers	Retrieves a paginated list of verified phone numbers for a specific organization team.	`CAL_GET_VERIFIED_PHONE_NUMBERS`
Retrieve my information	Retrieves the authenticated user’s core profile information (e.g., name, email, timezone).	`CAL_RETRIEVE_MY_INFORMATION`
Retrieve provider details	Verifies and retrieves details for an OAuth client (provider) in Cal.com’s Platform API.	`CAL_RETRIEVE_PROVIDER_DETAILS`
Retrieve v2 conferencing info	Retrieves an authenticated Cal user’s or organization’s video conferencing configurations, capabilities, and installed apps, useful for understanding options before scheduling or verifying setups.	`CAL_RETRIEVE_V2_CONFERENCING_INFO`
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 tokens.	`CAL_SAVE_OAUTH_CREDENTIALS_VIA_GCAL_API`
Save Stripe details	Completes the Stripe OAuth flow by saving Stripe details.	`CAL_SAVE_STRIPE_DETAILS`

Connect Cal.com

Before you start:

You need a Cal.com account that you can sign in to.
Your Squad subscription must be active. Squad does not connect apps while the subscription is not active.

Open Integrations

Open Settings > Integrations.

Add an integration

On the Connected apps tab, click + Add integration.

Find Cal.com

Find Cal.com in the catalog and click it. You can type the name in Search the catalog….

Keep the default level

Under Default scope, keep Default. It is the only option.

Click Connect Cal.com

Click Connect Cal.com. The Cal.com sign-in page opens in a new tab.

Check that it works: Cal.com shows under YOUR CONNECTIONS, with a row for the account and its access level.

Set access for one agent

Every agent can use the account unless you block it.

Under YOUR CONNECTIONS, open the account menu (⋯) on the Cal.com account.
Click Manage scope.
Under Per-agent access, find the agent.
Choose No access to block the agent. Choose Default (Default) to allow it again.
Click Save access.

Changes apply from the agent’s next call. An agent with No access does not see the account.

Use more than one Cal.com account

Click + Account on the Cal.com card to connect another account. Agents use the primary account unless they are asked to use a specific one.

After you click + Account, follow the connect steps above.
The first account you connect becomes the primary account. It shows ★ PRIMARY.
To change the primary account, open the account menu (⋯) and click Make primary.
To tell accounts apart, open the account menu (⋯) and click Rename.

Reconnect or disconnect

Reconnect when the connection has expired, or when you need to change what the account can reach on the Cal.com side:

Open the account menu (⋯) and click Reconnect.
Click Reauthorize on Cal.com.
Sign in to Cal.com and approve the request.

Reconnect signs in to the same account again. It does not add a second connection. Open the account menu (⋯) on the Cal.com account and click Disconnect. Agents lose access to that account at once.

Disconnect acts at once, with no confirmation step. If it was the primary account, another connected Cal.com account becomes primary.

Costs

Cal.com actions do not use Squad credits. Connected apps never use credits. For what does use credits, see What Squad costs.

Troubleshooting

An agent says it has no access to Cal.com, or it does not see the account.

Cause: the agent is set to No access under Per-agent access, or the account is not connected.
Fix: open Manage scope and change the agent’s row. If the account is missing, connect it again.

Connecting or saving fails with “Your subscription isn’t active.”

Cause: your Squad subscription is not active.
Fix: resubscribe. See Manage your subscription.

An agent says the Cal.com connection has expired.

Cause: the sign-in for that account is no longer valid.
Fix: use Reconnect on the account.

Common questions

Can I limit what agents can do in Cal.com?

You cannot choose a narrower level for Cal.com. You can block single agents with No access under Per-agent access.

Can I connect more than one Cal.com account?

Click + Account on the Cal.com card to connect another account. Agents use the primary account unless they are asked to use a specific one.

How do I disconnect Cal.com?

Open the account menu (⋯) on the Cal.com account and click Disconnect. Agents lose access to that account at once.

Connect apps

Add an MCP server or an API key

Use this when an action you need is not in this app.

Recommended

Analytics

Communication

CRM & Support

Dev & Project Management

E-commerce & Payments

Email & Productivity

File Storage

Finance & Time

Marketing & Social

Scheduling & Meetings

Access levels

What agents can do

Connect Cal.com

Set access for one agent

Use more than one Cal.com account

Reconnect or disconnect

Costs

Troubleshooting

Common questions

Connect apps

Add an MCP server or an API key

​Access levels

​What agents can do

​Connect Cal.com

​Set access for one agent

​Use more than one Cal.com account

​Reconnect or disconnect

​Costs

​Troubleshooting

​Common questions

​Related pages

Connect apps

Add an MCP server or an API key

Access levels

What agents can do

Connect Cal.com

Set access for one agent

Use more than one Cal.com account

Reconnect or disconnect

Costs

Troubleshooting

Common questions

Related pages