> ## Documentation Index
> Fetch the complete documentation index at: https://squad.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Cal.com
> What agents can do in Cal.com with standard access, and how to connect, limit, and disconnect 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
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| Action | What it does | Slug |
| ---------------------- | ------------------------------------------------------------------- | ---------------------------- |
| Get team routing forms | Retrieves routing forms for a specific team within an organization. | `CAL_GET_TEAM_ROUTING_FORMS` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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` |
| 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 **Settings** > **Integrations**.
On the **Connected apps** tab, click **+ Add integration**.
Find **Cal.com** in the catalog and click it. You can type the name in **Search the catalog…**.
Under **Default scope**, keep **Default**. It is the only option.
Click **Connect Cal.com**. The Cal.com sign-in page opens in a new tab.
Sign in to Cal.com and approve the request.
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.
1. Under **YOUR CONNECTIONS**, open the account menu (⋯) on the Cal.com account.
2. Click **Manage scope**.
3. Under **Per-agent access**, find the agent.
4. Choose **No access** to block the agent. Choose **Default (Default)** to allow it again.
5. 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:
1. Open the account menu (⋯) and click **Reconnect**.
2. Click **Reauthorize on Cal.com**.
3. 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](/docs/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](/docs/billing).
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
You cannot choose a narrower level for Cal.com. You can block single agents with **No access** under **Per-agent access**.
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.
Open the account menu (⋯) on the Cal.com account and click **Disconnect**. Agents lose access to that account at once.
## Related pages
Use this when an action you need is not in this app.