Cal.com

Overview

Cal.com is an open-source scheduling platform that simplifies meeting coordination through shareable booking pages, calendar syncing, and availability management. With the Cal.com integration in SquadOS, your agents can create, cancel, and reschedule meetings, check available time slots, manage event types, and configure availability schedules — all programmatically, without manual intervention.

• Official website: https://cal.com/
• Composio documentation: docs.composio.dev/toolkits/cal

Authentication

This tool supports two authentication modes: OAuth 2.0 (OAUTH2) and API key (API_KEY).

You will need the following fields (API_KEY mode):

Field	Required	Description
api_key	Yes	API key generated in the Cal.com dashboard under Settings → Developer → API Keys.

For OAuth 2.0 mode, no manual fields are needed — the authorization flow is completed on the Composio secure connection page.

How to get credentials

To use API key mode:

1. Go to app.cal.com and log in to your account.
2. Click Settings in the left sidebar.
3. Go to Developer → API Keys.
4. Click Add to generate a new key.
5. Give the key a name (e.g., “SquadOS”) and set the desired expiration date.
6. Copy the generated value — it will not be displayed again.

Tip

Use a dedicated API key for SquadOS with a defined expiration date. Cal.com allows you to revoke keys individually without affecting other integrations.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Cal.com.
3. Click the card to open the details modal and hit Connect.
4. You’re taken to the secure connection page hosted by Composio, where you authorize access via OAuth 2.0 or enter the API key obtained above.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available to your agents. (Connection-flow details in Organization Tools.)

Available actions

Note

This integration exposes 175 actions in total. The most relevant ones are listed below; see the full list in the Composio documentation.

Create a new booking

CAL_POST_NEW_BOOKING_REQUEST

Creates a new booking for an event type at a specified start time. Use this action to schedule a meeting with a Cal.com user. Prerequisites: (1) get a valid event type ID from CAL_LIST_EVENT_TYPES; (2) find an available time slot using CAL_GET_AVAILABLE_SLOTS_INFO; (3) provide attendee name and email in the responses object. The booking will be created with status ACCEPTED if no confirmation is required, or PENDING if the event type requires host confirmation.

Input parameters

Name	Type	Required	Description
start	string	Yes	Start date and time in ISO 8601 format in UTC (e.g., ‘2024-09-15T10:00:00Z’). Must be an available slot from CAL_GET_AVAILABLE_SLOTS_INFO.
language	string	Yes	ISO 639-1 language code for communications with the attendee (e.g., ‘en’ for English, ‘es’ for Spanish).
timeZone	string	Yes	IANA timezone identifier for the attendee (e.g., ‘America/New_York’, ‘Europe/London’).
responses	object	Yes	Attendee details object. Required keys: name (full name) and email (valid email address).
eventTypeId	integer	No	Unique numeric identifier of the event type to be booked. Required if eventTypeSlug is not provided.
eventTypeSlug	string	No	Slug of the event type. When used, must be combined with username or teamSlug.
guests	array	No	List of additional guest email addresses to invite.
location	object	No	Location object matching one of the event type’s configured locations.
metadata	object	No	Custom key-value metadata for tracking or analytics. Max 50 keys.
lengthInMinutes	integer	No	Duration of the event in minutes. Only use when the event type supports multiple selectable durations.
bookingFieldsResponses	object	No	Responses to custom booking fields defined for the event type. Required if the event type has mandatory custom fields.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Fetch all bookings

CAL_FETCH_ALL_BOOKINGS

Fetches a list of bookings for the authenticated user, optionally filtered by status, attendee, date range, or by event/team IDs, with support for pagination and sorting.

Input parameters

Name	Type	Required	Description
skip	integer	No	Number of bookings to skip from the beginning of results (for pagination).
take	integer	No	Maximum number of bookings to return (for pagination).
status	array	No	Filter bookings by status. E.g., ["upcoming", "past"].
teamId	integer	No	Filter bookings by a single team ID of which the user is a member.
afterStart	string	No	Filter bookings starting after this ISO 8601 date/time string.
beforeEnd	string	No	Filter bookings ending before this ISO 8601 date/time string.
eventTypeId	integer	No	Filter by event type ID belonging to the user.
attendeeEmail	string	No	Filter by the exact email address of an attendee.
attendeeName	string	No	Filter by the name of an attendee.
sortStart	string	No	Sort results by booking start time (asc or desc).
sortEnd	string	No	Sort results by booking end time (asc or desc).
sortCreated	string	No	Sort results by booking creation time (asc or desc).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Retrieve booking details by uid

CAL_RETRIEVE_BOOKING_DETAILS_BY_UID

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

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	Unique identifier (UID) of the booking.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Reschedule booking by uid

CAL_RESCHEDULE_BOOKING_BY_UID

Reschedules 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

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking that needs to be rescheduled.
start	string	Yes	The new start time for the booking in ISO 8601 format (e.g., ‘2024-08-13T10:00:00Z’).
rescheduledBy	string	No	Email of the person who is rescheduling. If the event type owner email is provided, the rescheduled booking will be automatically confirmed.
reschedulingReason	string	No	The reason for rescheduling the booking.
emailVerificationCode	string	No	Required when event type has email verification enabled.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Cancel booking via uid

CAL_CANCEL_BOOKING_VIA_UID

Cancels an existing and active Cal.com booking using its unique identifier (UID).

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking to be cancelled.
cancellationReason	string	No	Optional reason for cancelling the booking. Recommended for clear communication with the attendee.
seatUid	string	No	For seated bookings only: the UID of the specific seat to cancel.
cancelSubsequentBookings	boolean	No	For recurring bookings only: if true, cancels this booking and all subsequent recurrences.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Confirm booking by uid

CAL_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). Finalizes the booking without modifying its details.

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking that needs to be confirmed.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Decline booking with reason

CAL_DECLINE_BOOKING_WITH_REASON

Declines a pending booking using its bookingUid, optionally with a reason. This action is irreversible and applies only to bookings awaiting confirmation.

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking to be declined.
reason	string	No	Reason provided by the host for declining the booking. Recommended for clear communication with the attendee.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Edit booking by ID

CAL_EDIT_BOOKING_BY_ID

Tool to edit an existing booking by its ID. Use when you need to update booking details such as title, description, status, or time.

Input parameters

Name	Type	Required	Description
id	integer	Yes	ID of the booking to edit.
title	string	No	Booking event title.
description	string	No	Description of the meeting.
status	string	No	Status values for a booking: ACCEPTED, PENDING, CANCELLED, or REJECTED.
start	string	No	Start time of the event in ISO 8601 date-time format.
end	string	No	End time of the event in ISO 8601 date-time format.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Mark booking absent for UID

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

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking.
host	boolean	No	If true, marks the host as absent. If null or omitted, host attendance status is unchanged.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Check calendar availability

CAL_CHECK_CALENDAR_VERSION2

Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details.

Input parameters

Name	Type	Required	Description
calendar	string	Yes	The calendar type to check availability for. Must be one of the supported calendar providers.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Get available slots info

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

Input parameters

Name	Type	Required	Description
eventTypeId	integer	Yes	Unique numeric identifier for the event type.
startTime	string	Yes	Start date and time in UTC (ISO 8601 format) from which to fetch available slots. Must be before endTime.
endTime	string	Yes	End date and time in UTC (ISO 8601 format) until which to fetch available slots. Must be after startTime.
timeZone	string	No	IANA timezone identifier (e.g., ‘America/New_York’) for the returned slot times.
duration	integer	No	Desired slot duration in minutes. Typically used for dynamic events with non-fixed lengths.
slotFormat	string	No	Format of returned slot times. Use range for start and end times; use time for start times only.
usernameList	array	No	Required for dynamic or collective event types to specify the users whose availability to consider.
rescheduleUid	string	No	UID of an existing booking being rescheduled. Helps find slots suitable for the reschedule context.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Reserve slot for event

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

Input parameters

Name	Type	Required	Description
eventTypeId	integer	Yes	The unique identifier for the event type for which the time slot is being reserved.
slotUtcStartDate	string	Yes	The start date and time of the slot to be reserved, in UTC (ISO 8601 format).
slotUtcEndDate	string	Yes	The end date and time of the slot to be reserved, in UTC (ISO 8601 format).
bookingUid	string	No	Optional unique identifier, typically used for events with seats.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

List event types

CAL_LIST_EVENT_TYPES

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

Input parameters

Name	Type	Required	Description
username	string	No	The username of the user whose event types are to be retrieved. Required if eventSlug is provided.
eventSlug	string	No	The slug of a specific event type to retrieve. If provided, username must also be supplied.
usernames	string	No	A comma-separated string of usernames to retrieve dynamic event types for multiple users (e.g., ‘alice,bob’).
orgId	integer	No	The unique identifier of the user’s organization.
orgSlug	string	No	The slug of the user’s organization.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Retrieve event type by id

CAL_RETRIEVE_EVENT_TYPE_BY_ID

Retrieves comprehensive details for a specific, existing Cal.com event type using its unique ID. This is a read-only action and does not return associated events or bookings.

Input parameters

Name	Type	Required	Description
eventTypeId	string	Yes	The unique identifier for the event type. Typically a numerical value or UUID string found in the event type settings URL.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Edit event type by ID

CAL_EDIT_EVENT_TYPE_BY_ID

Tool 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

Name	Type	Required	Description
id	integer	Yes	ID of the eventType to edit.
title	string	No	Title of the event type.
slug	string	No	Unique slug for the event type.
hidden	boolean	No	If the event type should be hidden from your public booking page.
price	integer	No	Price of the event type booking.
hosts	array	No	List of hosts for team event types.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete event type by id

CAL_DELETE_EVENT_TYPE_BY_ID

Permanently deletes an existing event type by its ID, which invalidates its scheduling links. The operation is irreversible; while existing bookings are unaffected, no new bookings can be made for this event type.

Input parameters

Name	Type	Required	Description
eventTypeId	integer	Yes	The unique numerical identifier of the event type to be deleted.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Retrieve schedules list

CAL_RETRIEVE_SCHEDULES_LIST

Retrieve all availability schedules for the authenticated Cal.com user. Each schedule includes availability time blocks, timezone, and whether it’s the default schedule. Returns an empty list if no schedules are configured.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Fetch schedule by id

CAL_FETCH_SCHEDULE_BY_ID

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

Input parameters

Name	Type	Required	Description
scheduleId	integer	Yes	Unique identifier of the schedule to retrieve.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Create user availability schedule

CAL_CREATE_USER_AVAILABILITY_SCHEDULE

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

Input parameters

Name	Type	Required	Description
name	string	Yes	Descriptive name for the availability schedule (e.g., ‘Working Hours’, ‘Holiday Schedule’).
timeZone	string	Yes	IANA timezone identifier (e.g., ‘America/New_York’). Essential for correct event availability calculation.
isDefault	boolean	Yes	Sets this as the user’s default schedule if true, replacing any existing default. Each user must have exactly one default schedule.
availability	array	No	List of availability objects defining active days and time slots. If omitted, defaults to Mon-Fri, 09:00-17:00 in the schedule’s timezone.
overrides	array	No	List of override objects for specific date exceptions (e.g., holidays). Overrides take precedence over weekly availability.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Edit availability by ID

CAL_EDIT_AVAILABILITY_BY_ID

Tool 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

Name	Type	Required	Description
id	integer	Yes	ID of the availability to edit.
days	array	No	Array of integers depicting weekdays (0=Sunday, 1=Monday, 2=Tuesday, 3=Wednesday, 4=Thursday, 5=Friday, 6=Saturday). Only values 0-6 are valid.
startTime	string	No	Start time of the availability in ISO 8601 datetime format (e.g., ‘1970-01-01T10:00:00.000Z’). The date portion is ignored; only the time is used.
endTime	string	No	End time of the availability in ISO 8601 datetime format (e.g., ‘1970-01-01T16:00:00.000Z’). The date portion is ignored; only the time is used.
scheduleId	integer	No	ID of schedule this availability is associated with.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Delete schedule by id

CAL_DELETE_SCHEDULE_BY_ID

Permanently deletes a specific schedule using its unique identifier.

Input parameters

Name	Type	Required	Description
scheduleId	integer	Yes	The unique identifier of the schedule to be deleted.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Retrieve my information

CAL_RETRIEVE_MY_INFORMATION

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

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Get teams list

CAL_GET_TEAMS_LIST

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

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Add attendee

CAL_ADD_ATTENDEE

Tool to create a new attendee for an existing booking in Cal.com. Use when you need to add an additional participant to a scheduled event.

Input parameters

Name	Type	Required	Description
bookingId	integer	Yes	The unique identifier of the booking to add the attendee to.
name	string	Yes	Full name of the attendee.
email	string	Yes	Email address of the attendee. Must be a valid email format.
timeZone	string	Yes	IANA timezone for the attendee (e.g., ‘America/New_York’, ‘Europe/London’).

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

List all attendees

CAL_LIST_ATTENDEES

Tool to retrieve all attendees from Cal.com. Use when you need to get a complete list of all attendees across all bookings.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Fetch event type details

CAL_FETCH_EVENT_TYPE_DETAILS

Fetches all configuration settings and characteristics for a single team event type, identified by orgId, teamId, and eventTypeId. Read-only action.

Input parameters

Name	Type	Required	Description
orgId	integer	Yes	The unique identifier of the organization to which the event type belongs.
teamId	integer	Yes	The unique identifier of the team within the specified organization.
eventTypeId	integer	Yes	The unique identifier of the specific event type.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.

Reassign booking to another user

CAL_REASSIGN_BOOKING_TO_ANOTHER_USER

Reassigns an existing booking to a specified user. The booking owner must be authorized to perform the reassignment.

Input parameters

Name	Type	Required	Description
bookingUid	string	Yes	The unique identifier (UID) of the booking to be reassigned.
reason	string	No	An optional text explaining the reason for reassigning the booking. Useful for audit trails or internal communication.

Output

Name	Type	Required	Description
data	string	Yes	Data from the action execution.
error	string	No	Error if any occurred during execution.
successful	boolean	Yes	Whether or not the action execution was successful.