- Category: scheduling & booking
- Auth: API_KEY, OAUTH2
- Composio-managed OAuth available? Yes
- Tools: 175
- Triggers: 0
- Slug:
CAL - Version: 20261101_00
Tools
Add attendee
Add attendee
Add member to team
Add member to team
CAL_ADD_MEMBER_TO_TEAM_USING_ORG_AND_TEAM_IDAdds a new member to a specified team within an organization by creating a team membership.Input Parameters
True for active member, False for pending status.True, this user cannot be impersonated by administrators or those with impersonation privileges.Output
Add organization attribute option
Add organization attribute option
CAL_ADD_ORGANIZATION_ATTRIBUTE_OPTIONAdds a new option to an organization’s SINGLE_SELECT or MULTI_SELECT attribute. Use this action to extend the available choices for an existing attribute. For example, adding a new department option like “Marketing” to a “Department” attribute. Prerequisites: - The organization must exist and the user must have admin access - The attribute must already exist and be of type SINGLE_SELECT or MULTI_SELECT Common use cases: - Adding new department options to a department selector - Expanding location choices for a location attribute - Creating new priority levels for a priority field Note: While it’s recommended to use unique slugs for clarity, the API may allow duplicate slugs.Input Parameters
Output
Cancel booking via uid
Cancel booking via uid
CAL_CANCEL_BOOKING_VIA_UIDCancels a Cal.com booking by UID. For seated or recurring bookings, it can target a seat or cancel subsequent recurrences; a recurring booking UID can cancel all recurrences.Input Parameters
Output
Check calendar availability
Check calendar availability
CAL_CHECK_CALENDAR_VERSION2Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible calendar, noting that data granularity can vary.Input Parameters
Output
Check gcal synchronization status
Check gcal synchronization status
Check ics feed calendar endpoint
Check ics feed calendar endpoint
Check Stripe status
Check Stripe status
Check team stripe integration status
Check team stripe integration status
Confirm booking by uid
Confirm booking by uid
Connect to calendar
Connect to calendar
Create membership for organization
Create membership for organization
CAL_CREATE_MEMBERSHIP_FOR_ORGANIZATIONCreates a new membership for a user within a Cal.com organization. The caller must have admin/owner access to the organization, and the target user must already exist in the system. Use CAL_RETRIEVE_USERS_IN_ORGANIZATION to get valid user IDs.Input Parameters
Output
Create oauth client user
Create oauth client user
CAL_CREATE_OAUTH_CLIENT_USERCreates a new managed user for a Cal.com Platform OAuth client. This is a Platform API endpoint that requires OAuth client credentials (clientId and x-cal-secret-key). The endpoint is deprecated as of December 2025 but remains functional for existing Platform customers. Key behaviors: - If timeZone is provided: A default working schedule (Mon-Fri, 9AM-5PM) is automatically created - If timeZone is omitted: No default schedule is created; you must manually create one via the /schedules endpoint before the user can receive bookings Returns access and refresh tokens for the created managed user that should be stored securely. Access tokens expire in 60 minutes; refresh tokens expire in 1 year.Input Parameters
clientId in the API path.Output
Create OAuth client webhook configuration
Create OAuth client webhook configuration
CAL_CREATE_OAUTH_CLIENT_WEBHOOK_CONFIGURATIONCreates a webhook configuration for an OAuth client to receive real-time event notifications from Cal.com. This is a Platform API endpoint that requires OAuth client credentials (clientId and x-cal-secret-key). Use this to set up automated workflows by subscribing to events like BOOKING_CREATED, BOOKING_CANCELLED, MEETING_ENDED, FORM_SUBMITTED, and more. The webhook will POST event data to your specified subscriberUrl. Key features: - Subscribe to multiple event triggers in a single webhook - Optionally customize the payload using a template - Secure webhooks with a secret for signature verification (X-Cal-Signature-256 header) - Control webhook activation status (active/inactive) Note: This endpoint is part of the deprecated Platform offering but remains functional for existing customers.Input Parameters
subscriberUrl to verify that incoming requests are genuinely from Cal.com. If provided, Cal.com will include an X-Cal-Signature-256 header in webhook requests.subscriberUrl. Refer to Cal.com documentation (cal.com/docs/core-features/webhooks) for details on template syntax and available variables.Output
Create organization attributes
Create organization attributes
CAL_CREATE_ORGANIZATION_ATTRIBUTESCreates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles.Input Parameters
true to enable, false to disable. If not specified, the system’s default behavior for new attributes (e.g., enabled) will apply.SINGLE_SELECT or MULTI_SELECT types, this list must contain at least one option definition. For TEXT or NUMBER types, an empty list [] should be provided.Output
Create organization team form workflow
Create organization team form workflow
CAL_CREATE_ORGANIZATION_TEAM_FORM_WORKFLOWTool to create a new workflow for routing forms within an organization team. Use when you need to set up automated actions (like sending emails or SMS) triggered by routing form submissions. Supports notification workflows with customizable triggers, steps, and activation settings.Input Parameters
Output
Create organization webhook by org ID
Create organization webhook by org ID
CAL_CREATE_ORGANIZATION_WEBHOOK_BY_ORG_IDCreates 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). Returns the webhook configuration including its unique ID, which can be used to update or delete the webhook later.Input Parameters
true, webhook is active upon creation and sends notifications; false creates it disabled.X-Cal-Signature-256 header, allowing subscriberUrl to verify request origin.subscriberUrl. At least one trigger must be provided.subscriberUrl. Supports template variables like {{triggerEvent}}, {{bookingId}}, {{type}}, {{title}}, {{organizer.name}}, {{attendees.0.name}}, etc. If omitted, Cal.com sends a default payload with all event data.Output
Create or update team profile
Create or update team profile
CAL_CREATE_OR_UPDATE_TEAM_PROFILECreates a new team profile, or updates one if a ‘slug’ matches, customizing branding, scheduling, privacy, and operational details.Input Parameters
Output
Create phone call event
Create phone call event
CAL_CREATE_PHONE_CALL_EVENTSchedules a phone call event in Cal.com using existing eventType, organization, and team IDs; this action only registers the event details and does not initiate the actual phone call.Input Parameters
Output
Create phone call for event type
Create phone call for event type
CAL_CREATE_PHONE_CALL_FOR_EVENT_TYPEConfigures Cal.ai phone call automation for a team event type, enabling AI-powered outbound calls for appointment reminders or custom conversations. Requires team membership - first use CAL_GET_TEAMS_LIST to get a valid teamId, then CAL_GET_EVENT_TYPE_BY_TEAM_ID or CAL_RETRIEVE_TEAM_EVENT_TYPES to get an eventTypeId belonging to that team. Note: This creates the call configuration but does not immediately initiate a call. Cal.ai charges $0.29/minute for AI calls.Input Parameters
Output
Create team event type
Create team event type
CAL_CREATE_TEAM_EVENT_TYPECreates a new event type for a specified team in Cal.com; ensure teamId, any provided scheduleId, hosts.userId, and destinationCalendar details are valid and accessible.Input Parameters
userId. For round-robin, mandatory and priority can be set. Either provide hosts OR set assignAllTeamMembers=true, not both.{'perSlot': 10, 'attendeeNoun': 'participant', 'showAttendees': True}.lengthInMinutes is 60). Defaults to lengthInMinutes if not specified.{'type': 'MANUAL', 'message': 'Your booking requires manual approval.'}.hosts when all team members should handle this event type.lengthInMinutes value.Output
Create team event types with custom options
Create team event types with custom options
CAL_CREATE_TEAM_EVENT_TYPES_WITH_CUSTOM_OPTIONSCreates a highly customizable Cal.com team event type with extensive scheduling, booking, and host assignment options; schedulingType is required, lengthInMinutes must be included in lengthInMinutesOptions, destination calendar details (from /api/v2/calendars) must be valid if provided, and host User IDs must be valid team members.Input Parameters
{"enabled": true, "per_slot": 10, "show_remaining_seats": true, "attendee_questions": [{"name": "department", "label": "Department", "type": "text", "required": false}]}.[{"type": "cal_video"}, {"type": "address", "address": "123 Main St, Anytown, USA"}]{"frequency": "weekly", "interval": 1, "count": 10} (weekly for 10 occurrences) or {"frequency": "daily", "until": "2024-12-31T23:59:59Z"}.lengthInMinutes is 60 and slotInterval is 30, slots like 9:00, 9:30, 10:00 will be shown for the 60-minute event. Defaults to lengthInMinutes if not specified.[{"name": "company_size", "label": "Company Size", "type": "select", "options": ["1-10", "11-50"], "required": false}]{"type": "rolling_days", "days": 30} (up to 30 days in advance) or {"type": "date_range", "startDate": "2024-01-01T00:00:00Z", "endDate": "2024-03-31T23:59:59Z"}.{"period": "day", "count": 1} (one per day) or {"period": "rolling_days_period", "count": 2, "days": 7} (2 per rolling 7 days).{"type": "manual_confirmation", "threshold_period": "24h", "threshold_bookings": 10} or {"type": "automatic_confirmation"}.hosts list can be empty or will be supplemented.{"period": "week", "duration": 120} (120 minutes per week).lengthInMinutes must be included in this list./api/v2/calendars.Output
Create team in organization
Create team in organization
CAL_CREATE_TEAM_IN_ORGANIZATIONCreates a new team with customizable attributes within an existing and accessible Cal.com organization specified by orgId.Input Parameters
Output
Create team invite link
Create team invite link
CAL_CREATE_TEAM_INVITE_LINKCreates a shareable invite link for a Cal.com team that allows new members to join. Returns both the raw token and a complete invitation URL.Input Parameters
Output
Create team membership with role
Create team membership with role
CAL_CREATE_TEAM_MEMBERSHIP_WITH_ROLEAdds a user to a team with a specified role, acceptance status, and impersonation settings; ensure teamId and userId refer to existing, valid entities.Input Parameters
true, the user is added directly to the team without needing to accept an invitation.Output
Create user availability schedule
Create user availability schedule
CAL_CREATE_USER_AVAILABILITY_SCHEDULECreates a Cal.com user availability schedule, defining its name, timezone, weekly recurring availability, and specific date overrides; if isDefault is true, this schedule replaces any existing default and applies to event types not linked to a specific schedule.Input Parameters
Output
Create user schedule in organization
Create user schedule in organization
CAL_CREATE_USER_SCHEDULE_IN_ORGANIZATIONCreates a new schedule defining a user’s availability with weekly slots and date-specific overrides in an organization; setting ‘isDefault’ to true may replace an existing default schedule for the user.Input Parameters
Output
Create webhook for event type
Create webhook for event type
CAL_CREATE_WEBHOOK_FOR_EVENT_TYPECreates a webhook for an existing eventTypeId in Cal.com, sending notifications for specified triggers to a subscriberUrl that handles POST requests.Input Parameters
subscriberUrl, allowing variables like {{type}}. Refer to cal.com/docs/core-features/webhooks for more details.Output
Decline booking with reason
Decline booking with reason
CAL_DECLINE_BOOKING_WITH_REASONDeclines a pending booking using its bookingUid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation.Input Parameters
Output
Delete all team event type webhooks
Delete all team event type webhooks
Delete conference app connection
Delete conference app connection
CAL_DELETE_CONFERENCE_APP_CONNECTIONDisconnects the specified conferencing application (e.g., ‘zoom’, ‘google_meet’) for the Cal.com account, immediately terminating any ongoing call or meeting; use with caution.Input Parameters
Output
Delete destination calendar by id
Delete destination calendar by id
Delete event type by id
Delete event type by id
Delete event type in team
Delete event type in team
CAL_DELETE_EVENT_TYPE_IN_TEAMPermanently removes an event type’s configuration from a team’s scheduling options (e.g., for cleanup); this action is irreversible and requires the event type to be associated with the team.Input Parameters
Output
Delete membership in team
Delete membership in team
CAL_DELETE_MEMBERSHIP_IN_TEAMUse 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.Input Parameters
Output
Delete OAuth Client Managed User
Delete OAuth Client Managed User
CAL_DELETE_OAUTH_CLIENT_USERPermanently removes a managed user’s association with an OAuth client without deleting their Cal.com account. This is a Cal.com Platform API endpoint for developers who manage users through OAuth clients. Prerequisites: - A registered OAuth client application (provides clientId) - The OAuth client secret key (x_cal_secret_key) - A valid managed user ID that was created under this OAuth client The deleted user’s information is returned in the response for confirmation. Note: This endpoint is marked as deprecated in Cal.com docs but remains functional for existing Platform customers.Input Parameters
Output
Delete oauth client webhook
Delete oauth client webhook
CAL_DELETE_OAUTH_CLIENT_WEBHOOKPermanently deletes a specific webhook for an OAuth client in Cal.com Platform API. This endpoint is part of the Cal.com Platform API and requires valid OAuth client credentials. When a webhook is deleted, it will stop receiving notifications for all configured event triggers. Prerequisites: - A Platform-enabled Cal.com organization (requires isPlatform: true) - Valid OAuth client credentials (clientId and x_cal_secret_key) - An existing webhook created for the OAuth client Typical Use Case: Remove webhook subscriptions that are no longer needed, helping to manage and clean up your OAuth client’s notification endpoints. Note: This endpoint is marked as deprecated in Cal.com documentation and may be removed in future versions. Consider using alternative webhook management endpoints when available.Input Parameters
Output
Delete organization attribute
Delete organization attribute
CAL_DELETE_ORGANIZATION_ATTRIBUTEPermanently deletes an existing attribute (specified by attributeId) from an existing organization (specified by orgId); this action is irreversible and may affect features dependent on the attribute.Input Parameters
Output
Delete organization attribute option
Delete organization attribute option
CAL_DELETE_ORGANIZATION_ATTRIBUTE_OPTIONPermanently deletes a specified option from an organization’s attribute. Use this action to remove an option value from attributes of type SINGLE_SELECT or MULTI_SELECT. This is useful for cleaning up unused or deprecated configuration choices. Note: This action is destructive and cannot be undone. The option will be permanently removed. Requires organization admin access.Input Parameters
Output
Delete organization membership
Delete organization membership
Delete org webhook
Delete org webhook
CAL_DELETE_ORG_WEBHOOKPermanently deletes an organization-level webhook by its ID. This action removes the specified webhook from the organization, stopping all future notifications to its subscriber URL. The deletion is irreversible - the webhook configuration cannot be recovered after deletion. Requirements: - User must be authenticated and have admin permissions in the organization - The webhook must exist within the specified organization - Use ‘retrieve_organization_webhooks_by_org_id’ to list webhooks before deletionInput Parameters
Output
Delete schedule by id
Delete schedule by id
Delete selected calendars
Delete selected calendars
CAL_DELETE_SELECTED_CALENDARSRemoves a specified, currently selected calendar from the user’s active list within the application, without deleting it from the external provider.Input Parameters
Output
Delete selected slot
Delete selected slot
Delete team by id
Delete team by id
Delete team event type in organization
Delete team event type in organization
CAL_DELETE_TEAM_EVENT_TYPE_IN_ORGANIZATIONPermanently removes a team event type from an organization’s scheduling configuration. Use when cleaning up unused event types or consolidating team scheduling options.Input Parameters
Output
Delete team from organization
Delete team from organization
CAL_DELETE_TEAM_FROM_ORGANIZATIONPermanently and irreversibly deletes a specific team from a Cal.com organization. WARNING: This action cannot be undone and will remove all associated team data including memberships, event types, and bookings. Requires ORG_ADMIN role in the organization.Input Parameters
Output
Delete team memberships by id
Delete team memberships by id
Delete user attribute option
Delete user attribute option
CAL_DELETE_USER_ATTRIBUTE_OPTIONUnassigns a specific attribute option from a user within an organization. Use this action to remove an attribute option assignment (e.g., skill, role, department) from a specific user. This does NOT delete the attribute option itself from the organization - it only removes the association between the user and that option. The attribute option must currently be assigned to the user. To find assigned attribute options for a user, use the ‘Get all attribute options for a user’ endpoint first. Requires organization admin access. The operation is reversible by re-assigning the attribute option to the user using the ‘Assign attribute option to user’ endpoint.Input Parameters
Output
Delete user from organization
Delete user from organization
Delete user schedule
Delete user schedule
Delete webhook by id
Delete webhook by id
Delete webhook for event type
Delete webhook for event type
Delete webhooks for event type
Delete webhooks for event type
Disconnect calendar using credential id
Disconnect calendar using credential id
CAL_DISCONNECT_CALENDAR_USING_CREDENTIAL_IDDisconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal’s access; external calendar data remains unaffected.Input Parameters
Output
Edit attendee by ID
Edit attendee by ID
Edit availability by ID
Edit availability by ID
CAL_EDIT_AVAILABILITY_BY_IDTool to edit an existing availability by ID on Cal.com. Use when you need to update the days, start time, end time, or schedule association of an existing availability.Input Parameters
Output
Edit booking by ID
Edit booking by ID
Edit event type by ID
Edit event type by ID
CAL_EDIT_EVENT_TYPE_BY_IDTool to edit an existing Cal.com event type by ID. Use when you need to update event type settings like title, description, duration, locations, or booking configurations.Input Parameters
Output
Edit selected calendar by ID
Edit selected calendar by ID
CAL_EDIT_SELECTED_CALENDAR_BY_IDTool to edit a selected calendar by its composite ID in Cal.com. Use when you need to update an existing calendar integration.Input Parameters
Output
Fetch all bookings
Fetch all bookings
CAL_FETCH_ALL_BOOKINGSFetches 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.Input Parameters
Output
Fetch event type details
Fetch event type details
CAL_FETCH_EVENT_TYPE_DETAILSFetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and be accessible; this read-only action cannot list, create, or modify event types.Input Parameters
Output
Fetch organization attribute by id
Fetch organization attribute by id
CAL_FETCH_ORGANIZATION_ATTRIBUTE_BY_IDRetrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record.Input Parameters
Output
Fetch provider access token
Fetch provider access token
CAL_FETCH_PROVIDER_ACCESS_TOKENFetches an OAuth access token for the specified clientId to authenticate API calls; this action only retrieves the token, not managing scheduling or calendar events.Input Parameters
Output
Fetch schedule by id
Fetch schedule by id
Fetch user schedule by org id
Fetch user schedule by org id
CAL_FETCH_USER_SCHEDULE_BY_ORG_IDRetrieves a specific user’s schedule within an organization, returning availability windows, timezone settings, and date-specific overrides. Requires organization-level access permissions.Input Parameters
Output
Fetch webhook by event type id
Fetch webhook by event type id
Force refresh user oauth client
Force refresh user oauth client
CAL_FORCE_REFRESH_USER_OAUTH_CLIENTForces an immediate refresh of OAuth tokens for a Platform managed user. This is a Cal.com Platform API endpoint (deprecated as of December 2025 but still functional for existing customers). Use this endpoint when you’ve lost a managed user’s access or refresh tokens and need to obtain new ones. Prerequisites: - A registered OAuth client application with Cal.com (provides clientId and x_cal_secret_key) - The managed user must exist and be associated with your OAuth client - Valid OAuth client credentials (clientId and secret key) Token Validity: - Access tokens are valid for 60 minutes - Refresh tokens are valid for 1 year Important: Store the returned tokens securely in your database (e.g., as calAccessToken and calRefreshToken fields).Input Parameters
Output
Get all timezones
Get all timezones
Get available slots info
Get available slots info
CAL_GET_AVAILABLE_SLOTS_INFORetrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type.Input Parameters
startTime.endTime.eventTypeId.Output
Get booking reference by id
Get booking reference by id
Get booking references
Get booking references
CAL_GET_BOOKING_REFERENCESRetrieves external references for a specific booking within an organization’s team. Use when you need to get calendar or video platform integration details for a booking.Input Parameters
Output
Get default schedule details
Get default schedule details
Get destination calendars
Get destination calendars
Get event type by team id
Get event type by team id
Get event type private links
Get event type private links
Get google calendar oauth authentication url
Get google calendar oauth authentication url
Get oauth clients user
Get oauth clients user
CAL_GET_OAUTH_CLIENTS_USERLists managed users associated with a Platform OAuth client, with an optional limit on the number returned. The endpoint uses OAuth client credentials and is deprecated.Input Parameters
Output
Get organization attribute assigned options
Get organization attribute assigned options
CAL_GET_ORGANIZATION_ATTRIBUTE_ASSIGNED_OPTIONSRetrieves all assigned attribute options for a specific attribute within an organization. This action returns the list of attribute options that have been assigned to users, along with which users have been assigned each option. For example, if you have a “Department” attribute, this will show which department options exist and which users are assigned to each department. Use cases: - View which users are assigned to specific attribute options - Monitor attribute option assignments across teams - Audit user attribute assignments for reporting - Filter results by specific option IDs or team IDs Prerequisites: - The organization must exist (use get_organization_id to retrieve your orgId) - The attribute must exist with options assigned to usersInput Parameters
Output
Get organization attribute assigned options by slug
Get organization attribute assigned options by slug
CAL_GET_ORGANIZATION_ATTRIBUTE_ASSIGNED_OPTIONS_BY_SLUGTool to retrieve all assigned attribute options for a specific attribute by its slug within an organization. Use when you need to see which attribute options have been assigned to users, filtered by the attribute’s slug identifier.Input Parameters
Output
Get organization ID
Get organization ID
Get organization schedules
Get organization schedules
CAL_GET_ORGANIZATION_SCHEDULESRetrieves availability schedules for an organization. Returns schedules that define when users are available for bookings, including working hours, time zones, and date-specific overrides. These are not individual events or appointments, but rather the availability templates that determine when bookings can be made.Input Parameters
Output
Get organization teams event types
Get organization teams event types
CAL_GET_ORGANIZATION_TEAMS_EVENT_TYPESRetrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by orgId.Input Parameters
Output
Get organization team workflows
Get organization team workflows
CAL_GET_ORGANIZATION_TEAM_WORKFLOWSRetrieves workflows configured for a specific team within an organization. Returns workflow configurations including triggers, steps, and activation settings. Use when you need to list or inspect workflow automations for a team.Input Parameters
Output
Get organization user schedules
Get organization user schedules
Get private links for team event type
Get private links for team event type
Get schedule for user in team
Get schedule for user in team
CAL_GET_SCHEDULE_FOR_USER_IN_TEAMRetrieves all availability schedules for a specific user within a team and organization. Returns schedule configurations including working hours, time zones, weekly availability patterns, default schedule designation, and date-specific overrides. Use this to understand when a team member is available for bookings. Requires valid userId (from team memberships), orgId (from organization list), and teamId (from teams list).Input Parameters
Output
Get selected calendar by ID
Get selected calendar by ID
CAL_GET_SELECTED_CALENDAR_BY_IDRetrieves a selected calendar using its user ID, integration and external ID. This action uses the Cal.com v1 API and requires an API key in the connection’s Bearer authorization header.Input Parameters
Output
Get stripe connect info
Get stripe connect info
Get Stripe Connect URL for team
Get Stripe Connect URL for team
CAL_GET_STRIPE_CONNECT_URLTool to get Stripe Connect authorization URL for a team within an organization. Use when you need to obtain a URL that allows team members to connect their Stripe account for payment processing on Cal.com.Input Parameters
Output
Get team bookings
Get team bookings
Get team default conferencing app
Get team default conferencing app
CAL_GET_TEAM_DEFAULT_CONFERENCING_APPRetrieves the default conferencing application configured for a specific team within an organization. Use this to check which video platform (e.g., Zoom, Google Meet) is set as the team’s default for scheduling meetings.Input Parameters
Output
Get team details by organization ID and team ID
Get team details by organization ID and team ID
CAL_GET_TEAM_DETAILS_BY_ORG_ID_AND_TEAM_IDRetrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and timezone/week preferences. Use this to get team information like name, slug, bio, timezone, branding colors, and visibility settings.Input Parameters
Output
Get team event type webhook
Get team event type webhook
CAL_GET_TEAM_EVENT_TYPE_WEBHOOKRetrieves details for a specific webhook configured on a team event type. Use when you need to inspect webhook configuration, verify settings, or troubleshoot webhook deliveries for team-managed event types.Input Parameters
Output
Get team event type webhooks
Get team event type webhooks
CAL_GET_TEAM_EVENT_TYPE_WEBHOOKSRetrieves webhooks configured for a specific team event type, with optional pagination using take and skip. Use this to audit webhook configurations or troubleshoot webhook delivery issues.Input Parameters
Output
Get team information by team ID
Get team information by team ID
CAL_GET_TEAM_INFORMATION_BY_TEAM_IDRetrieves detailed information about a specific Cal.com team by its ID. Returns team configuration including name, slug, branding (logo, colors, theme), timezone settings, and privacy options. Requires the authenticated user to be a member of the team. Use ‘get_teams_list’ to find available team IDs.Input Parameters
Output
Get team routing forms
Get team routing forms
CAL_GET_TEAM_ROUTING_FORMSRetrieves routing forms for a specific team within an organization. Routing forms are used to collect information from potential bookers and route them to appropriate event types or team members based on their responses. Use this to fetch routing form configurations, fields, and routing logic for a team.Input Parameters
Output
Get team schedules
Get team schedules
CAL_GET_TEAM_SCHEDULESRetrieves availability schedules for all members of a specific team within an organization. Returns schedules that define when team members are available for bookings, including working hours, time zones, and date-specific overrides.Input Parameters
Output
Get teams list
Get teams list
Get verified phone numbers
Get verified phone numbers
CAL_GET_VERIFIED_PHONE_NUMBERSRetrieves a paginated list of verified phone numbers for a specific organization team. Use when you need to get phone numbers that have been verified and associated with a team.Input Parameters
Output
Get webhook by id
Get webhook by id
Handle conferencing oauth callback for app
Handle conferencing oauth callback for app
CAL_HANDLE_CONFERENCING_OAUTH_CALLBACK_FOR_APPProcesses an OAuth 2.0 callback for a conferencing app, exchanging the code and state for access credentials; ensure an OAuth flow was previously initiated.Input Parameters
Output
List all attendees
List all attendees
List booking references
List booking references
CAL_LIST_BOOKING_REFERENCESFetches one page of bookings and extracts their references, with caller-driven cursor pagination. An empty references list can reflect a page with no references; pagination stops when the response has no usable next cursor.Input Parameters
booking_references in the response will vary.next_cursor from a previous response. Omit on the first call; pass the value verbatim (as either int or str — Cal.com may return either) to fetch the next page. The value is a Cal.com booking-ID keyset (this action pins cal-api-version 2024-06-11, which always returns dict-format with a native nextCursor) and should be treated as opaque by callers.Output
List event types
List event types
CAL_LIST_EVENT_TYPESRetrieves Cal event types, filterable by username (required if eventSlug is provided), multiple usernames, or organization details (orgSlug or orgId).Input Parameters
orgSlug is not required. Fetches event types associated with this organization.orgId is not required. Fetches event types associated with this organization.username must also be supplied, as multiple users can have events with the same slug.Output
List organization memberships
List organization memberships
CAL_LIST_ORGANIZATION_MEMBERSHIPSRetrieves organization memberships with user details, roles, acceptance status, and custom attributes. Supports pagination.Input Parameters
Output
List team event types by org and team id
List team event types by org and team id
CAL_LIST_TEAM_EVENT_TYPES_BY_ORG_AND_TEAM_IDRetrieves all event types for a specific team within an organization, optionally filtering by a specific event slug.Input Parameters
Output
Mark booking absent for UID
Mark booking absent for UID
Modify organization membership by id
Modify organization membership by id
Modify org attribute by id
Modify org attribute by id
CAL_MODIFY_ORG_ATTRIBUTE_BY_IDPartially updates an organization attribute using orgId and attributeId, allowing modification of its name, slug, type, or enabled status; changing the ‘type’ may affect existing data.Input Parameters
Output
Patch organization attribute option
Patch organization attribute option
CAL_PATCH_ORGANIZATION_ATTRIBUTE_OPTIONPartially 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.Input Parameters
Output
Patch organization user details
Patch organization user details
Patch team details by ID
Patch team details by ID
CAL_PATCH_TEAM_DETAILS_BY_IDUpdates specified details for an existing team identified by teamId; unspecified fields remain unchanged.Input Parameters
Output
Patch webhook event type
Patch webhook event type
CAL_PATCH_WEBHOOK_EVENT_TYPEUpdates configuration (e.g., payload template, active status, URL, triggers, secret) for an existing webhook tied to a specific event type.Input Parameters
subscriberUrl. See Cal.com documentation (cal.com/docs/core-features/webhooks) for syntax and variables.Output
Post calendar credentials
Post calendar credentials
CAL_POST_CALENDAR_CREDENTIALSUse to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar services for synchronization.Input Parameters
Output
Connect conferencing app
Connect conferencing app
CAL_POST_CONFERENCING_APP_CONNECTConnects Google Meet to Cal.com for a user who already has a valid Google Calendar connection, enabling future virtual meeting scheduling.Input Parameters
Output
Create a new booking
Create a new booking
CAL_POST_NEW_BOOKING_REQUESTCreates a booking for an event type at a specified start time. Identify the event type by ID or by its slug with a user or team slug, and provide attendee responses, timezone and language.Input Parameters
Output
Assign or create attribute option for user
Assign or create attribute option for user
CAL_POST_ORG_ATTRIBUTE_OPTION_BY_USERAssigns 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.Input Parameters
attributeId and then assigned to the user; use this if not assigning an existing option via attributeOptionId.attributeId. Use this when assigning a pre-existing option instead of creating a new one with value. Either attributeOptionId or value should be provided, not both.Output
Add selected calendar
Add selected calendar
CAL_POST_SELECTED_CALENDARSLinks 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.Input Parameters
Output
Post user to organization
Post user to organization
CAL_POST_USER_TO_ORGANIZATIONAdds a new user to an existing organization (identified by orgId in path), requiring user’s email and allowing extensive optional profile customization.Input Parameters
Output
Create webhook subscription
Create webhook subscription
CAL_POST_WEBHOOK_EVENTCreates 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. Supports custom payload templates and webhook signature verification via HMAC-SHA256.Input Parameters
Output
Reassign booking to another user
Reassign booking to another user
CAL_REASSIGN_BOOKING_TO_ANOTHER_USERReassigns the host of a round-robin booking to a specified user. The booking owner’s authorization is required, and the tool uses API version 2024-08-13.Input Parameters
Output
Reassign booking with uid
Reassign booking with uid
Refresh oauth token for client id
Refresh oauth token for client id
CAL_REFRESH_OAUTH_TOKEN_FOR_CLIENT_IDRefreshes an OAuth access token for a specified clientId and managed user using their refreshToken. This is a Cal.com Platform feature for developers building applications that manage users. Prerequisites: - A registered OAuth client application with Cal.com (provides clientId) - The OAuth client secret key (x_cal_secret_key) - A valid refresh token obtained when creating a managed user The endpoint implements refresh token rotation - both access and refresh tokens are returned. Access tokens expire after 60 minutes; refresh tokens expire after 1 year. Note: This endpoint is marked as deprecated in Cal.com docs and may be replaced in future versions.Input Parameters
Output
Request email verification code
Request email verification code
CAL_REQUEST_EMAIL_VERIFICATION_CODERequest an email verification code for a team’s verified resources. Use this action when you need to verify an email address for a team. The API will send a verification code to the specified email address. After receiving the code, you’ll need to use it with a separate verification endpoint to complete the email verification process. This is typically used to verify email addresses that will be used as verified resources within a team.Input Parameters
Output
Reschedule booking by uid
Reschedule booking by uid
CAL_RESCHEDULE_BOOKING_BY_UIDReschedules an existing booking (identified by bookingUid) to a new time. Requires the booking UID and the new start time in ISO 8601 format. Optionally, you can provide a rescheduling reason and the email of the person rescheduling.Input Parameters
Output
Reserve slot for event
Reserve slot for event
CAL_RESERVE_SLOT_FOR_EVENTTemporarily 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.Input Parameters
Output
Retrieve attribute options for org
Retrieve attribute options for org
CAL_RETRIEVE_ATTRIBUTE_OPTIONS_FOR_ORGRetrieves all available options for a specific attribute within an organization. This action returns the list of selectable options for SINGLE_SELECT or MULTI_SELECT type attributes. For example, if you have a “Department” attribute, this will return options like “Engineering”, “Marketing”, “Sales”. Note: TEXT and NUMBER type attributes do not have options and will return an empty list. Use cases: - Retrieve available departments, locations, or other categorical options - Display attribute options in a user interface for selection - Validate that a specific option exists before assigning it to a user Prerequisites: - The organization must exist (use get_organization_id to retrieve your orgId) - The attribute must exist (use retrieve_organization_attributes to get attributeId) - Only SINGLE_SELECT and MULTI_SELECT attributes will have optionsInput Parameters
Output
Retrieve booking details by uid
Retrieve booking details by uid
Retrieve calendar busy times
Retrieve calendar busy times
CAL_RETRIEVE_CALENDAR_BUSY_TIMESTo find busy calendar slots for scheduling/conflict detection, call this with a valid credentialId, an externalId accessible by it, and a recognized IANA loggedInUsersTz; returns only busy intervals, not event details or free slots. Use credentialId/externalId for single calendar queries.Input Parameters
loggedInUsersTz is assumed.loggedInUsersTz is assumed. If not provided, the system may use a default start time (e.g., the current time).dateFrom and dateTo if they don’t contain explicit timezone information.Output
Retrieve calendar list
Retrieve calendar list
Retrieve current team for organization
Retrieve current team for organization
CAL_RETRIEVE_CURRENT_TEAM_FOR_ORGANIZATIONRetrieves details of the team(s) for the currently authenticated user within the specified organization orgId.Input Parameters
Output
Retrieve default conferencing settings
Retrieve default conferencing settings
Retrieve event type by id
Retrieve event type by id
CAL_RETRIEVE_EVENT_TYPE_BY_IDRetrieves 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 events or bookings.Input Parameters
https://app.cal.com/event-types/<eventTypeId>) or via other API endpoints that list event types.Output
Retrieve membership from organization
Retrieve membership from organization
CAL_RETRIEVE_MEMBERSHIP_FROM_ORGANIZATIONRetrieves detailed information about a specific membership within a particular organization.Input Parameters
Output
Retrieve my information
Retrieve my information
Retrieve OAuth client user by ID
Retrieve OAuth client user by ID
CAL_RETRIEVE_OAUTH_CLIENT_USER_BY_IDRetrieves detailed profile information for a specific managed user associated with an OAuth client. This endpoint is part of Cal.com’s Platform API for OAuth client management. It requires: - A valid OAuth client ID (clientId) obtained from the Cal.com Platform dashboard - A valid managed user ID (userId) that was created via the create managed user endpoint - OAuth client secret key (x_cal_secret_key) for authentication Returns the user’s profile including email, name, timezone, schedule settings, and custom metadata. Note: This endpoint requires Platform API access which is available to registered OAuth clients.Input Parameters
Output
Retrieve oauth client webhook by id
Retrieve oauth client webhook by id
CAL_RETRIEVE_OAUTH_CLIENT_WEBHOOK_BY_IDRetrieves detailed configuration for a specific webhook by ID from a Platform OAuth client. This Platform API endpoint requires OAuth client credentials (clientId and x-cal-secret-key) to access webhook settings including subscriber URL, active status, event triggers, payload template, and verification secret. Prerequisites: Platform OAuth client created at https://app.cal.com/settings/platform/oauth-clients with both client ID and secret key. Note: Platform offering deprecated Dec 2025, available only to existing enterprise customers. Use cases: Verify webhook config after creation, check active status for troubleshooting, retrieve secret for signature verification, audit settings.Input Parameters
Output
Retrieve organization attributes
Retrieve organization attributes
Retrieve organization attributes options
Retrieve organization attributes options
CAL_RETRIEVE_ORGANIZATION_ATTRIBUTES_OPTIONSRetrieves all attribute options assigned to a specific user within an organization. Attribute options are customizable organizational metadata (like department, role, location, or team) that organizations define and assign to users for flexible categorization and management.Input Parameters
Output
Retrieve organization webhook by id
Retrieve organization webhook by id
Retrieve organization webhooks by org ID
Retrieve organization webhooks by org ID
CAL_RETRIEVE_ORGANIZATION_WEBHOOKS_BY_ORG_IDRetrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers, subscriber URL, active status, etc.). Supports pagination via take and skip parameters. This is a read-only operation that does not modify any webhooks.Input Parameters
Output
Retrieve provider details
Retrieve provider details
CAL_RETRIEVE_PROVIDER_DETAILSVerifies and retrieves details for an OAuth client (provider) in Cal.com’s Platform API. This endpoint is part of Cal.com’s Platform API for managing OAuth clients. It verifies the OAuth client credentials (clientId and x-cal-secret-key) and returns provider details including the client ID, associated organization ID, and provider name. Use this to: - Verify that OAuth client credentials are valid - Retrieve the organization ID associated with an OAuth client - Get the registered name of the OAuth client/provider Authentication: Requires both the OAuth client ID (path parameter) and x-cal-secret-key (header). These credentials are obtained from https://app.cal.com/settings/platform/oauth-clients.Input Parameters
Output
Retrieve schedules list
Retrieve schedules list
CAL_RETRIEVE_SCHEDULES_LISTRetrieve all availability schedules for the authenticated Cal.com user. This action returns a list of schedules that define when a user is available for bookings. Each schedule includes availability time blocks, timezone, and whether it’s the default schedule. Use this to: - List all configured schedules for a user - Find the default schedule (isDefault=true) - Get schedule IDs for use with other actions like updating or deleting schedules Returns an empty list if no schedules are configured.Output
Retrieve team details in organization
Retrieve team details in organization
CAL_RETRIEVE_TEAM_DETAILS_IN_ORGANIZATIONRetrieves a paginated list of teams and their details for a specified organization. Use the optional page size and offset to browse the organization’s teams.Input Parameters
Output
Retrieve team event types
Retrieve team event types
CAL_RETRIEVE_TEAM_EVENT_TYPESRetrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability.Input Parameters
Output
Retrieve team membership by id
Retrieve team membership by id
CAL_RETRIEVE_TEAM_MEMBERSHIP_BY_IDRetrieves detailed information for a specific team membership by its ID within an organization’s team. Returns membership details including the user’s role (MEMBER, OWNER, or ADMIN), acceptance status, impersonation settings, and user profile information (email, name, username, avatar, bio). Requires organization-level access permissions.Input Parameters
Output
Retrieve team membership details
Retrieve team membership details
CAL_RETRIEVE_TEAM_MEMBERSHIP_DETAILSRetrieves 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 members.Input Parameters
Output
Retrieve team memberships
Retrieve team memberships
CAL_RETRIEVE_TEAM_MEMBERSHIPSRetrieves team memberships, including roles and invitation acceptance status, with optional member details and pagination via take and skip. Access requires a team admin role or applicable team membership read permission.Input Parameters
Output
Retrieve team memberships for organization
Retrieve team memberships for organization
CAL_RETRIEVE_TEAM_MEMBERSHIPS_FOR_ORGANIZATIONRetrieves 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). Supports pagination via ‘take’ and ‘skip’ parameters.Input Parameters
Output
Retrieve users in organization
Retrieve users in organization
Retrieve v2 conferencing info
Retrieve v2 conferencing info
Retrieve webhook details for OAuth client
Retrieve webhook details for OAuth client
CAL_RETRIEVE_WEBHOOK_DETAILS_FOR_OAUTH_CLIENTRetrieves a paginated list of webhook configurations for a specific OAuth client through Cal.com’s deprecated Platform API. Platform OAuth client credentials are required.Input Parameters
Output
Retrieve webhooks for event type
Retrieve webhooks for event type
Retrieve webhooks list
Retrieve webhooks list
CAL_RETRIEVE_WEBHOOKS_LISTRetrieves 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.Input Parameters
Output
Save calendar entry
Save calendar entry
Save calendar ics feeds
Save calendar ics feeds
Save OAuth credentials via GCal API
Save OAuth credentials via GCal API
CAL_SAVE_OAUTH_CREDENTIALS_VIA_GCAL_APICompletes 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.Input Parameters
Output
Save stripe details
Save stripe details
CAL_SAVE_STRIPE_DETAILSCompletes the Stripe OAuth flow by saving Stripe details; call this when a user is redirected back from Stripe with an authorization code and state.Input Parameters
Output
Set default conferencing app
Set default conferencing app
CAL_SET_DEFAULT_CONFERENCING_APPSets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user.Input Parameters
Output
Update destination calendar integration
Update destination calendar integration
CAL_UPDATE_DESTINATION_CALENDAR_INTEGRATIONUpdates the destination calendar for syncing events, using integration and externalId (typically from /calendars endpoint).Input Parameters
/calendars endpoint./calendars endpoint.Output
Update OAuth client user settings
Update OAuth client user settings
CAL_UPDATE_OAUTH_CLIENT_USER_SETTINGSUpdates specified profile and scheduling preference fields for a user associated with an OAuth client; defaultScheduleId, if provided, must be an existing, valid schedule for the user.Input Parameters
Output
Update oauth client webhook
Update oauth client webhook
CAL_UPDATE_OAUTH_CLIENT_WEBHOOKUpdates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged.Input Parameters
true to enable notifications, or false to disable them. If omitted, the current active status is unchanged.X-Cal-Signature-256 HTTP header. Provide an empty string to remove an existing secret. If omitted, the existing secret is unchanged.subscriberUrl. Utilizes a templating language; see Cal.com documentation (cal.com/docs/core-features/webhooks) for syntax and available variables. If omitted, the existing template is unchanged.Output
Update private link
Update private link
Update schedule by ID
Update schedule by ID
CAL_UPDATE_SCHEDULE_BY_IDUpdates an existing schedule by its ID, allowing partial modification of properties; providing availability or overrides replaces them entirely.Input Parameters
Output
Update team event type
Update team event type
CAL_UPDATE_TEAM_EVENT_TYPETool to update a team event type in Cal.com. Use when modifying settings for a team’s event type such as duration, description, scheduling, locations, or any other event configuration.Input Parameters
Output
Update team event type webhook
Update team event type webhook
CAL_UPDATE_TEAM_EVENT_TYPE_WEBHOOKUpdates a webhook for a team event type. Use when you need to modify webhook configuration like active status, subscriber URL, triggers, or payload template.Input Parameters
Output
Update team information by id
Update team information by id
CAL_UPDATE_TEAM_INFORMATION_BY_IDUpdates an existing team’s information by its ID within a specified organization; the slug, if provided, must be unique within the organization.Input Parameters
Output
Update team membership by id
Update team membership by id
CAL_UPDATE_TEAM_MEMBERSHIP_BY_IDUpdates properties of an existing team membership. Supports partial updates - only provided fields are modified while others remain unchanged. Requires appropriate team permissions (admin or owner role). Use ‘Get teams list’ to find teamId and ‘Retrieve team memberships’ to find membershipId.Input Parameters
Output
Update team membership properties
Update team membership properties
CAL_UPDATE_TEAM_MEMBERSHIP_PROPERTIESUpdates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization. Only provided fields are changed (partial update). Requires organization admin or owner privileges. Use list memberships endpoint to get valid membershipId values.Input Parameters
Output
Update user profile details
Update user profile details
CAL_UPDATE_USER_PROFILE_DETAILSUpdates the authenticated user’s profile information and preferences using the provided fields. Email changes generally require verification before the primary email changes, unless the new email is already a verified secondary email or the user is platform-managed.Input Parameters
Output
Update user schedule in organization
Update user schedule in organization
CAL_UPDATE_USER_SCHEDULE_IN_ORGANIZATIONModifies an existing schedule for a specified user within an organization by updating only the provided fields; the organization, user, and schedule must already exist.Input Parameters
Output
Update webhook by id
Update webhook by id
CAL_UPDATE_WEBHOOK_BY_IDUpdates an existing Cal.com webhook by its webhookId, allowing partial modification of its attributes; only explicitly provided fields will be changed.Input Parameters
subscriberUrl. See Cal.com webhook documentation (cal.com/docs/core-features/webhooks) for templating details.Output
Update webhook for organization
Update webhook for organization
CAL_UPDATE_WEBHOOK_FOR_ORGANIZATIONUpdates an existing webhook for an organization. Use this to modify webhook settings such as the subscriber URL, activation status, event triggers, or verification secret. Requires admin access to the organization. Only fields provided in the request will be updated; omitted fields retain their current values.