Calendly

Overview

Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders, helping individuals and teams avoid email back-and-forth. With the Calendly integration in SquadOS, your agents can create event types, schedule meetings, check available time slots, and manage organization members directly via API, making scheduling workflows fully automated.

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

Authentication

This tool uses OAuth 2.0 (OAUTH2) to connect.

You will need the following fields:

Field	Required	Description
client_id	Yes	Client ID generated when creating the OAuth app in the Calendly developer portal.
client_secret	Yes	Client Secret generated alongside the Client ID in the Calendly developer portal.

How to get credentials

1. Go to developer.calendly.com and log in with your Calendly account.
2. Click My Apps, then select Create New App.
3. Fill in the application form: name (e.g., Composio-Calendly), type Web, and environment Sandbox (testing) or Production (live).
4. In the Redirect URI field, enter: https://backend.composio.dev/api/v3/toolkits/auth/callback (HTTPS required, no trailing slash).
5. Save the generated Client ID and Client Secret — you will need them in the next step.
6. Confirm the redirect URI appears correctly in your app settings.
7. Go to platform.composio.dev and click Create Auth Config, selecting Calendly.
8. Set the authentication type to OAuth2 and enable Use your own developer authentication.
9. Paste your Client ID and Client Secret in the Manage Auth Config tab and click create.
10. Copy the generated Auth Config ID (starting with ac_) — you will need it when connecting in SquadOS.

Tip

Use the minimum required scopes when creating your app: default, users:read, events:read, event_types:read, and webhook_subscriptions:write. Calendly’s OAuth model grants all requested scopes at once — individual scope approval is not possible after the fact.

How to connect in SquadOS

1. Go to Tools in the side menu (/admin/tools).
2. Open the Available tab and search for Calendly.
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.
5. Once done, you’re sent back to SquadOS with the account connected and the tool available for your agents. (Connection-flow details in Organization Tools.)

FAQ

Why can’t I configure individual scopes for Calendly?

Calendly’s OAuth model grants the access token for all requested scopes at once during authorization; users cannot selectively approve individual scopes. Configure scopes when creating your OAuth app — the resulting access token will include all requested permissions.

Available actions

Cancel scheduled event

CALENDLY_CANCEL_SCHEDULED_EVENT

Tool to cancel a scheduled Calendly event by creating a cancellation record. Use when you need to permanently cancel an existing, active event. The cancellation will trigger notifications to all invitees.

Input parameters

Name	Type	Required	Description
reason	string	No	Optional text explanation for why the event is being canceled. This reason will be included in the cancellation notification sent to invitees.
event_uuid	string	Yes	The unique identifier (UUID) of the scheduled event to cancel. This can be extracted from the scheduled_events URI or event details.

Output

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

Create event invitee (Deprecated)

CALENDLY_CREATE_EVENT_INVITEE

DEPRECATED: Use CALENDLY_POST_INVITEE instead. Tool to programmatically schedule Calendly meetings without UI redirects. Use when you need to book a meeting on behalf of an invitee via API. Requires a paid Calendly plan.

Input parameters

Name	Type	Required	Description
invitee	object	Yes	Details of the attendee being scheduled for the meeting.
location	object	Yes	Meeting location details. Required unless the event type omits location specification.
tracking	object	No	UTM parameters and tracking information for marketing attribution.
event_type	string	Yes	The event type to book. Accepts either the full URI (e.g., 'https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA') or just the UUID. Use list_user_s_event_types action to get available event types.
start_time	string	Yes	Meeting start time in ISO 8601 UTC format (e.g., '2025-10-02T18:30:00Z'). Use list_event_type_available_times action to check available slots before booking.
event_guests	array	No	List of additional email addresses to include as guests in the meeting.
questions_and_answers	array	No	List of custom question responses from the booking form. Include only if the event type has custom questions.

Output

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

Create Event Type

CALENDLY_CREATE_EVENT_TYPE

Tool to create a new one-on-one event type (kind: solo) in Calendly. Use when you need to programmatically create a new event type for scheduling meetings.

Input parameters

Name	Type	Required	Description
name	string	Yes	The event type name that will be displayed to invitees.
color	string	No	Hexadecimal color value for the scheduling page. Must match pattern ^#[a-f\d]{6}$ (e.g., '#fff200').
owner	string	Yes	The owner URI for this event type (e.g., 'https://api.calendly.com/users/AAAAAAAAAAAAAAAA'). Must be a valid user URI.
active	boolean	No	Indicates if the event type is active and available for booking. Defaults to false if not provided.
locale	string	No	Locale for the event type’s scheduling page language. Options: "de", "en", "es", "fr", "it", "nl", "pt", "uk".
duration	integer	No	Length of sessions in minutes. Must be between 1 and 720 minutes. Should be one of the duration_options if both are provided.
locations	array	No	Configuration information for each possible location where the event can take place.
description	string	No	The event type description that will be shown on the scheduling page.
duration_options	array	No	Alternative duration choices for flexible meetings. Maximum 4 unique values allowed. Each must be between 1 and 720 minutes.

Output

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

Create One-Off Event Type

CALENDLY_CREATE_ONE_OFF_EVENT_TYPE

Creates a temporary Calendly one-off event type for unique meetings outside regular availability, requiring valid host/co-host URIs, a future date/range for date_setting, and a positive duration.

Input parameters

Name	Type	Required	Description
host	string	Yes	The URI of the user who will be the host of the one-off event (e.g., 'https://api.calendly.com/users/xxx').
name	string	Yes	Name of the one-off event type.
duration	integer	Yes	Duration of the event in minutes. Note: Pass this as 'duration', not 'duration_minutes'.
location	object	No	Location configuration for the event.
timezone	string	No	IANA timezone identifier for the event scheduling. Determines how times are interpreted and displayed to invitees.
date_setting	string	Yes	Date & time availability for this one-off event. Must be an object with a type key equal to ONE of: 'date_range', 'days_in_future', or 'spots'. date_range: include start_date & end_date (YYYY-MM-DD). days_in_future: include days (int) and only_weekdays (bool). spots: include spots — list of objects with start_time and end_time (ISO 8601 datetime strings). Do NOT use values like 'available_moving' — that pertains to Shares, not one-off events.

Output

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

Create scheduling link

CALENDLY_CREATE_SCHEDULING_LINK

Create a single-use scheduling link. Creates a scheduling link that can be used to book an event. The link allows invitees to schedule up to the specified maximum number of events. Once the limit is reached, the link becomes inactive.

Input parameters

Name	Type	Required	Description
owner	string	Yes	Event type URI (e.g., 'https://api.calendly.com/event_types/...').
owner_type	string	No	Type of owner, typically 'EventType'.
max_event_count	integer	No	The max number of events that can be scheduled using this scheduling link. Must be exactly 1 for single-use scheduling links.

Output

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

Create share

CALENDLY_CREATE_SHARE

Creates a customizable, one-time share link for a Calendly event type, allowing specific overrides to its settings (e.g., duration, availability, location) without altering the original event type.

Input parameters

Name	Type	Required	Description
name	string	No	Custom name for the shared link; defaults to event type name if unspecified.
duration	integer	No	Custom event duration in minutes, overriding event type default.
end_date	string	No	End date (YYYY-MM-DD) for shared link availability; required if period_type is 'fixed'.
event_type	string	Yes	URI of the event type to base this share on.
start_date	string	No	Start date (YYYY-MM-DD) for shared link availability; required if period_type is 'fixed'.
period_type	string	No	Availability period type: 'available_moving' (shows actual available slots for max_booking_time days), 'moving' (available for max_booking_time days), 'fixed' (within start_date/end_date), 'unlimited'.
hide_location	boolean	No	If true, hides event location until booking (only if event type has a single custom location).
duration_options	array	No	Alternative selectable durations in minutes, overriding event type options.
max_booking_time	integer	No	Max days in advance an invitee can book; required if period_type is 'moving' or 'available_moving'.
location_configurations	array	No	Custom location settings that override the event type’s default locations.
availability__rule__rules	array	No	List of custom availability rules that override the event type’s default schedule. Provide an array of objects EACH containing: type='wday', wday (weekday), and intervals (list of {from, to} times). Field names are case-sensitive — use wday, from, to exactly. Must be combined with availability_rule_timezone.
availability__rule__timezone	string	No	IANA timezone (e.g., 'America/New_York') for custom availability rules. Required with availability_rule_rules.

Output

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

Create single use scheduling link

CALENDLY_CREATE_SINGLE_USE_SCHEDULING_LINK

Creates a one-time, single-use scheduling link for an active Calendly event type, expiring after one booking.

Input parameters

Name	Type	Required	Description
owner	string	Yes	The URI of the Calendly Event Type that will own this single-use scheduling link. This Event Type’s settings (e.g., duration, availability) will apply to the scheduled meeting.
owner_type	string	Yes	Identifies the owner resource type, which is 'EventType'.
max_event_count	integer	Yes	The maximum number of events that can be scheduled using this link. For a single-use link, this value must be 1.

Output

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

Create webhook subscription

CALENDLY_CREATE_WEBHOOKS

Tool to create a webhook subscription for receiving Calendly event notifications. Use when you need to set up automated notifications for events like meeting bookings or cancellations. Organization scope triggers webhooks for all events organization-wide, while user/group scopes limit triggering to specific users or groups.

Input parameters

Name	Type	Required	Description
url	string	Yes	The publicly accessible HTTPS callback URL where webhook events will be sent via POST requests. Must be active and able to receive POST requests.
user	string	No	URI reference to the user for user-scoped webhooks (e.g., 'https://api.calendly.com/users/AAAAAAAAAAAAAAAA'). Required when scope is 'user', otherwise omit.
group	string	No	URI reference to the group for group-scoped webhooks (e.g., 'https://api.calendly.com/groups/AAAAAAAAAAAAAAAA'). Required when scope is 'group', otherwise omit.
scope	string	Yes	Subscription scope determining which events trigger the webhook. 'organization' triggers for all events in the organization, 'user' triggers only for a specific user’s events, 'group' triggers only for a specific group’s events.
events	array	Yes	List of event types to subscribe to. Valid values: 'invitee.created', 'invitee.canceled', 'invitee_no_show.created', 'invitee_no_show.deleted', 'routing_form_submission.created', 'event_type.created', 'event_type.deleted', 'event_type.updated'. At least one event must be specified.
signing_key	string	No	Optional secret key (6–24 characters) used to generate signatures for webhook security validation. Helps verify that webhook POST requests are genuinely from Calendly.
organization	string	Yes	URI reference to the organization that owns this webhook subscription (e.g., 'https://api.calendly.com/organizations/AAAAAAAAAAAAAAAA'). Required for all webhook subscriptions.

Output

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

Delete invitee data

CALENDLY_DELETE_INVITEE_DATA

Permanently removes all invitee data associated with the provided emails from past organization events, for data privacy compliance (requires Enterprise subscription; deletion may take up to one week).

Input parameters

Name	Type	Required	Description
emails	array	Yes	Invitee email addresses for whom all associated data will be permanently removed.

Output

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

Delete invitee no show

CALENDLY_DELETE_INVITEE_NO_SHOW

Deletes an Invitee No-Show record by its uuid to reverse an invitee’s ‘no-show’ status; the uuid must refer to an existing record.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the Invitee No-Show record to be removed.

Output

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

Delete organization membership

CALENDLY_DELETE_ORGANIZATION_MEMBERSHIP

Tool to remove a user from a Calendly organization by membership UUID. Use when you need to revoke a user’s access to an organization. Requires admin rights; organization owners cannot be removed.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier of the organization membership to be removed. This is the membership UUID, not the user UUID.

Output

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

Delete scheduled event data

CALENDLY_DELETE_SCHEDULED_EVENT_DATA

For Enterprise users, initiates deletion of an organization’s scheduled event data between a start_time and end_time (inclusive, where start_time must be prior to or equal to end_time); actual data deletion may take up to 7 days to complete.

Input parameters

Name	Type	Required	Description
end_time	string	Yes	Defines the end of the data deletion period (UTC). Events ending at or before this time will be included. Must be within the past 24 months.
start_time	string	Yes	Defines the start of the data deletion period (UTC). Events starting at or after this time will be included. Must be within the past 24 months.

Output

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

Delete webhook subscription

CALENDLY_DELETE_WEBHOOK_SUBSCRIPTION

Deletes an existing webhook subscription to stop Calendly sending event notifications to its registered callback URL; this operation is idempotent.

Input parameters

Name	Type	Required	Description
webhook_uuid	string	Yes	The unique identifier (UUID) of the webhook subscription to be deleted.

Output

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

Get current user (Deprecated)

CALENDLY_GET_CURRENT_USER

DEPRECATED: Use CALENDLY_GET_USER instead. Retrieves detailed information about the currently authenticated Calendly user.

Output

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

Get event

CALENDLY_GET_EVENT

Use to retrieve a specific Calendly scheduled event by its UUID, provided the event exists in the user’s Calendly account.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	Unique identifier (UUID) of the Calendly event.

Output

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

Get event invitee

CALENDLY_GET_EVENT_INVITEE

Retrieves detailed information about a specific invitee of a scheduled event, using their unique UUIDs.

Input parameters

Name	Type	Required	Description
event_uuid	string	Yes	The unique identifier (UUID) of the scheduled event.
invitee_uuid	string	Yes	The unique identifier (UUID) of the invitee for the specified event.

Output

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

Get event type

CALENDLY_GET_EVENT_TYPE

Retrieves details for a specific Calendly event type, identified by its UUID, which must be valid and correspond to an existing event type.

Input parameters

Name	Type	Required	Description
uuid	string	No	Unique identifier (UUID) for the event type. This is a required path parameter — extract the UUID from the event type URI (e.g., for 'https://api.calendly.com/event_types/abc123', use 'abc123').

Output

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

Get event type availability

CALENDLY_GET_EVENT_TYPE_AVAILABILITY

Tool to retrieve availability schedules configured for a specific Calendly event type. Use when you need to get the availability rules including day-of-week schedules and date-specific overrides.

Input parameters

Name	Type	Required	Description
user	string	No	URI of the user associated with the event type. Optional parameter to filter by user.
event_type	string	Yes	URI of the event type whose availability schedules are to be listed. Must be a valid Calendly event type URI. Retrieve this URI from CALENDLY_LIST_EVENT_TYPES; using a URI not owned by the authenticated user returns a 403 error.

Output

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

Get group

CALENDLY_GET_GROUP

Retrieves all attributes of a specific Calendly group by its UUID; the group must exist.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	Unique identifier (UUID) of the Calendly group.

Output

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

Get group relationship

CALENDLY_GET_GROUP_RELATIONSHIP

Retrieves a specific Calendly group relationship by its valid and existing UUID, providing details on user-group associations and membership.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the group relationship to be retrieved.

Output

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

Get invitee no show

CALENDLY_GET_INVITEE_NO_SHOW

Retrieves details for a specific Invitee No Show record by its UUID; an Invitee No Show is marked when an invitee does not attend a scheduled event.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the Invitee No Show record to retrieve.

Output

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

Get organization

CALENDLY_GET_ORGANIZATION

Tool to retrieve information about a specific Calendly organization. Use when you need to get organization details such as name, slug, or timestamps.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the organization to retrieve. This is the alphanumeric string at the end of the organization URI.

Output

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

Get organization invitation

CALENDLY_GET_ORGANIZATION_INVITATION

Retrieves a specific Calendly organization invitation using its UUID and the parent organization’s UUID.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the specific organization invitation to retrieve.
org_uuid	string	Yes	The unique identifier (UUID) of the Calendly organization to which the invitation belongs.

Output

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

Get organization membership

CALENDLY_GET_ORGANIZATION_MEMBERSHIP

Retrieves a specific Calendly organization membership by its UUID, returning all its attributes.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the organization membership to retrieve.

Output

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

Get routing form

CALENDLY_GET_ROUTING_FORM

Retrieves a specific routing form by its UUID, providing its configuration details including questions and routing logic.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the routing form to retrieve.

Output

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

Get routing form submission

CALENDLY_GET_ROUTING_FORM_SUBMISSION

Tool to retrieve details about a specific routing form submission by its UUID. Use when you need submission details including questions, answers, and routing results.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier (UUID) of the routing form submission to retrieve. Extract from submission URI or webhook payload.

Output

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

Get sample webhook data

CALENDLY_GET_SAMPLE_WEBHOOK_DATA

Tool to retrieve sample webhook payload data for testing webhook subscriptions. Use when you need to verify webhook setup and understand the data structure before creating actual webhook subscriptions.

Input parameters

Name	Type	Required	Description
user	string	No	The URI of the user to retrieve sample webhook data for. Required when scope is 'user'. Format: https://api.calendly.com/users/{user_uuid}.
event	string	Yes	The webhook event type to retrieve sample data for. Valid values: 'invitee.created', 'invitee.canceled', 'routing_form_submission.created'.
scope	string	Yes	The scope level for the webhook data. Valid values: 'user' or 'organization'. Note: routing_form_submission.created events require 'organization' scope.
organization	string	Yes	The URI of the organization to retrieve sample webhook data for. This parameter is always required. Format: https://api.calendly.com/organizations/{organization_uuid}.

Output

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

Get user

CALENDLY_GET_USER

Retrieves comprehensive details for an existing Calendly user.

Input parameters

Name	Type	Required	Description
uuid	string	No	The unique identifier (UUID) of the user. Alternatively, use the literal string "me" to refer to the currently authenticated user (the caller). Defaults to "me" (current user) if not specified.

Output

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

Get user availability schedule

CALENDLY_GET_USER_AVAILABILITY_SCHEDULE

Retrieves an existing user availability schedule by its UUID; this schedule defines the user’s default hours of availability.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	Unique identifier (UUID) of the availability schedule.

Output

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

Get webhook subscription

CALENDLY_GET_WEBHOOK_SUBSCRIPTION

Retrieves the details of an existing webhook subscription, identified by its UUID, including its callback URL, subscribed events, scope, and state.

Input parameters

Name	Type	Required	Description
webhook_uuid	string	Yes	Unique identifier (UUID) of the webhook subscription to retrieve.

Output

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

Mark invitee as no-show

CALENDLY_INVITEE_NO_SHOW

Tool to mark an invitee as a no-show for a scheduled event. Use when an invitee fails to attend their scheduled meeting and you need to record their absence in Calendly.

Input parameters

Name	Type	Required	Description
invitee	string	Yes	URI of the Invitee to be marked as a no-show. This must be a valid URI referencing an existing invitee from a scheduled event (e.g., 'https://api.calendly.com/scheduled_events/GBGBDCAADAEDCRZ2/invitees/AAAAAAAAAAAAAAAA').

Output

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

List activity log entries

CALENDLY_LIST_ACTIVITY_LOG_ENTRIES

Retrieves a list of activity log entries for a specified Calendly organization (requires an active Enterprise subscription), supporting filtering, sorting, and pagination.

Input parameters

Name	Type	Required	Description
sort	array	No	Specifies the sort order for the results. Provide a list of sort criteria strings, each in the format 'field:direction' (e.g., 'occurred_at:asc').
actor	array	No	Filters activity log entries by the users who performed the actions. Provide a list of user URIs.
count	integer	No	The maximum number of activity log entries to return per page.
action	array	No	Filters entries by the specific action performed (e.g., 'user.created', 'event_type.updated'). Provide a list of action strings.
namespace	array	No	Filters entries by their category or domain (namespace). Common examples include 'user_management' or 'event_type_management'.
page_token	string	No	Token for pagination, used to fetch the next page of results.
search_term	string	No	Filters entries based on the search term. Supported operators: | (OR), + (AND), " " (exact phrase), - (exclude), () (precedence), * (prefix search).
organization	string	Yes	URI of the Calendly organization for which to retrieve activity log entries.
max_occurred_at	string	No	Timestamp in ISO 8601 UTC format. Filters entries to include only those that occurred at or before this time.
min_occurred_at	string	No	Timestamp in ISO 8601 UTC format. Filters entries to include only those that occurred at or after this time.

Output

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

List event invitees

CALENDLY_LIST_EVENT_INVITEES

Retrieves a list of invitees for a specified Calendly event UUID, with options to filter by status or email, and sort by creation time.

Input parameters

Name	Type	Required	Description
sort	string	No	Order results by the created_at field; use 'created_at:asc' for ascending or 'created_at:desc' for descending.
uuid	string	Yes	The unique identifier (UUID) of the event for which to list invitees.
count	integer	No	The number of invitees to return per page. Default is 20.
email	string	No	Filter results by a specific invitee’s email address.
status	string	No	Filter invitees by their status. Can be 'active' or 'canceled'.
page_token	string	No	A token to retrieve the next or previous page of results in a paginated collection.

Output

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

List events (Deprecated)

CALENDLY_LIST_EVENTS

DEPRECATED: Use CALENDLY_LIST_SCHEDULED_EVENTS instead. Retrieves a list of scheduled Calendly events. Exactly one of user, organization, or group must be provided to scope the query. The invitee_email parameter is a filter and cannot be used as a scope. Admin rights may be needed when filtering by organization or group.

Input parameters

Name	Type	Required	Description
sort	string	No	Sort order for the results. Accepts comma-separated field:direction values. Supported field: start_time. Supported directions: asc, desc.
user	string	No	Full Calendly API URI of the user whose events you want to list. MUST be a complete URI in the format 'https://api.calendly.com/users/{uuid}'. Shortcuts like 'me' are NOT supported — use CALENDLY_GET_CURRENT_USER to get the user URI first. Exactly ONE of user, organization, or group must be supplied.
count	integer	No	The number of events to return per page.
group	string	No	Full Calendly API URI of the group (team) whose events you want to list. MUST be a complete URI in the format 'https://api.calendly.com/groups/{uuid}'. Exactly ONE of user, organization, or group must be provided.
status	string	No	Filter events by their status. 'active' or 'canceled'.
page_token	string	No	Token for pagination to retrieve the next or previous set of results.
organization	string	No	Full Calendly API URI of the organization. Format: 'https://api.calendly.com/organizations/{uuid}'. Admin privileges may be required.
invitee_email	string	No	Invitee’s email address to filter events by. This is a filter parameter and cannot be used as a scope.
max_start_time	string	No	Include events with start times at or before this UTC timestamp (e.g., '2020-01-02T03:04:05.678123Z').
min_start_time	string	No	Include events with start times at or after this UTC timestamp (e.g., '2020-01-02T03:04:05.678123Z').

Output

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

List event type available times

CALENDLY_LIST_EVENT_TYPE_AVAILABLE_TIMES

Fetches available time slots for a Calendly event type within a specified time range; results are not paginated.

Input parameters

Name	Type	Required	Description
end_time	string	Yes	End datetime (exclusive) of the requested availability range, in UTC ISO 8601 format (e.g., 'YYYY-MM-DDTHH:MM:SSZ'). The duration between start_time and end_time cannot exceed 7 days.
event_type	string	Yes	The URI of the event type for which to find available times. This can be obtained by listing event types or from an event type object.
start_time	string	Yes	Start datetime (inclusive) of the requested availability range, in UTC ISO 8601 format. Must be in the future.

Output

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

List event type hosts

CALENDLY_LIST_EVENT_TYPE_MEMBERSHIPS

Tool to retrieve a list of event type hosts (memberships) for a specific event type. Use when you need to see which users are configured as hosts for an event type.

Input parameters

Name	Type	Required	Description
count	integer	No	Number of results to return per page. Must be a positive integer.
event_type	string	Yes	URI of the event type to retrieve memberships for. Format: 'https://api.calendly.com/event_types/{uuid}'. Pass the complete URI, not just the UUID.
page_token	string	No	Pagination token to retrieve a specific page of results. Use the 'next_page_token' from a previous response to get the next page.

Output

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

List Event Types

CALENDLY_LIST_EVENT_TYPES

Tool to list all Event Types associated with a specified User or Organization. Use when you need to retrieve event types for a user or organization. Use scheduling_url from results directly; do not manually construct event type URLs.

Input parameters

Name	Type	Required	Description
sort	string	No	Order results by field(s) and direction. Accepts comma-separated list of field:direction values (e.g., 'name:asc,created_at:desc'). Default: name:asc.
user	string	No	URI of the user whose event types to list. Exactly one of 'user' or 'organization' must be provided (mutually exclusive).
count	integer	No	Number of results per page.
active	boolean	No	Filter by active status. Return only active event types if true, only inactive if false, or all event types if omitted.
page_token	string	No	Pagination token for retrieving subsequent pages. Check pagination.next_page_token in the response; if non-null, pass it as page_token in the next call.
organization	string	No	URI of the organization whose event types to list. Exactly one of 'organization' or 'user' must be provided (mutually exclusive).
admin_managed	boolean	No	Filter by admin management status.
user_availability_schedule	string	No	URI of the user’s availability schedule. Used with 'user' parameter to filter event types by primary availability schedule.

Output

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

List group relationships

CALENDLY_LIST_GROUP_RELATIONSHIPS

Retrieves a list of group relationships defining an owner’s role (e.g., member, admin) within a group; an owner can have one membership per group but multiple admin roles across different groups.

Input parameters

Name	Type	Required	Description
count	integer	No	Number of records per page (max 100).
group	string	No	Filter results by group URI.
owner	string	No	Filter results by owner URI (Organization Membership or Invitation URI).
page_token	string	No	Token for retrieving a specific page of results.
organization	string	No	Filter results by organization URI.

Output

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

List groups

CALENDLY_LIST_GROUPS

Returns a list of groups for a specified Calendly organization URI, supporting pagination.

Input parameters

Name	Type	Required	Description
count	integer	No	The maximum number of groups to return per page. The value can range from 1 to 100.
page_token	string	No	A token to retrieve a specific page of results. Pass the 'next_page_token' from a previous response.
organization	string	Yes	The URI of the organization to filter groups by. For example, 'https://api.calendly.com/organizations/ORGANIZATION_UUID'.

Output

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

List organization invitations

CALENDLY_LIST_ORGANIZATION_INVITATIONS

Retrieves a list of invitations for a specific organization, identified by its UUID.

Input parameters

Name	Type	Required	Description
sort	string	No	Order of results by field(s) and direction (asc/desc); e.g., 'created_at:asc' or 'email:desc,status:asc'.
uuid	string	Yes	Unique identifier (UUID) of the organization.
count	integer	No	Number of results to return per page.
email	string	No	Filter by the recipient’s email address.
status	string	No	Filter by invitation status: 'pending', 'accepted', or 'declined'.
page_token	string	No	Pagination token to access a specific page of results.

Output

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

List organization memberships

CALENDLY_LIST_ORGANIZATION_MEMBERSHIPS

Retrieves a list of organization memberships.

Input parameters

Name	Type	Required	Description
user	string	No	Filter memberships by the URI of the user. At least one of 'organization' or 'user' is required.
count	integer	No	The number of membership records to return per page. Must be an integer between 1 and 100, inclusive.
email	string	No	Filter memberships by the email address of the user. Must be used with 'organization' or 'user'.
page_token	string	No	The token to retrieve the next or previous page of results in a paginated collection.
organization	string	No	Filter memberships by the URI of the organization. At least one of 'organization' or 'user' is required.

Output

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

List outgoing communications

CALENDLY_LIST_OUTGOING_COMMUNICATIONS

Retrieves a list of outgoing SMS communications for a specified organization; requires an Enterprise subscription and if filtering by creation date, both min_created_at and max_created_at must be provided to form a valid range.

Input parameters

Name	Type	Required	Description
count	integer	No	The number of records to return per page. Must be between 1 and 100, inclusive.
page_token	string	No	The token to retrieve the next page of results.
organization	string	Yes	The URI of the organization whose outgoing communications are to be retrieved.
max_created_at	string	No	Include outgoing communications that were created before this timestamp. Formatted as "YYYY-MM-DDTHH:MM:SS.sssZ" in UTC.
min_created_at	string	No	Include outgoing communications that were created after this timestamp. Formatted as "YYYY-MM-DDTHH:MM:SS.sssZ" in UTC.

Output

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

List routing forms

CALENDLY_LIST_ROUTING_FORMS

Retrieves routing forms for a specified organization; routing forms are questionnaires used to direct invitees to appropriate booking pages or external URLs.

Input parameters

Name	Type	Required	Description
sort	string	No	Specifies the order of results. Use a comma-separated list of field:direction pairs. Supported field: created_at. Supported directions: asc, desc.
count	integer	No	The number of routing forms to return per page.
page_token	string	No	Token to retrieve a specific page of results.
organization	string	Yes	The URI of the organization for which to retrieve routing forms.

Output

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

List scheduled events

CALENDLY_LIST_SCHEDULED_EVENTS

Tool to retrieve a list of scheduled Calendly events. Use when you need to view events for a specific user, organization, or group. Requires exactly one of user, organization, or group parameter to scope the query.

Input parameters

Name	Type	Required	Description
sort	string	No	Order results by the specified field and direction. Format: 'field:direction'. Supported field: 'start_time'. Supported directions: 'asc', 'desc'.
user	string	No	Full Calendly API URI of the user. Format: 'https://api.calendly.com/users/{uuid}'. Shortcuts like 'me' are NOT supported. Exactly ONE of user, organization, or group must be provided.
count	integer	No	Number of events to return per page. Must be a positive integer.
group	string	No	Full Calendly API URI of the group (team). Format: 'https://api.calendly.com/groups/{uuid}'. Exactly ONE of user, organization, or group must be provided.
status	string	No	Filter events by their status. 'active' for active events or 'canceled' for canceled events.
page_token	string	No	Pagination token to retrieve a specific page of results.
organization	string	No	Full Calendly API URI of the organization. Format: 'https://api.calendly.com/organizations/{uuid}'. Admin privileges may be required.
invitee_email	string	No	Return events that are scheduled with the invitee associated with this email address. This is a filter parameter and must be used with a scope parameter.
max_start_time	string	No	Include events with start times prior to this time. Must be in UTC format (ISO 8601).
min_start_time	string	No	Include events with start times after this time. Must be in UTC format (ISO 8601).

Output

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

List user availability schedules

CALENDLY_LIST_USER_AVAILABILITY_SCHEDULES

Retrieves all availability schedules for the specified Calendly user.

Input parameters

Name	Type	Required	Description
user	string	Yes	URI of the user whose availability schedules are to be listed; must be a valid Calendly user URI.

Output

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

List user busy times

CALENDLY_LIST_USER_BUSY_TIMES

Fetches a user’s busy time intervals (internal and external calendar events) in ascending order for a period up to 7 days; keyset pagination is not supported.

Input parameters

Name	Type	Required	Description
user	string	Yes	The URI of the user whose busy times are being queried. This is typically the user’s Calendly API URI.
end_time	string	Yes	The end of the time range for which to fetch busy times, in RFC3339 format (e.g., '2023-10-26T11:00:00Z'). Must be after start_time.
start_time	string	Yes	The start of the time range for which to fetch busy times, in RFC3339 format (e.g., '2023-10-26T10:00:00Z').

Output

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

List User Meeting Locations

CALENDLY_LIST_USER_LOCATIONS

Tool to retrieve configured meeting location information for a given Calendly user. Use when you need to see all available location options configured by a user for their meetings.

Input parameters

Name	Type	Required	Description
user	string	Yes	URI of the user whose locations to list. This should be the full Calendly user URI (e.g., 'https://api.calendly.com/users/AAAAAAAAAAAAAAAA').

Output

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

List user event types (Deprecated)

CALENDLY_LIST_USER_S_EVENT_TYPES

DEPRECATED: Use CALENDLY_LIST_EVENT_TYPES instead. Retrieves event types for a user or organization; requires either the user or organization URI.

Input parameters

Name	Type	Required	Description
sort	string	No	Order results by field(s) and direction ('asc' or 'desc'), e.g., 'name:asc,created_at:desc'. Supported fields: name, position, created_at, updated_at. Defaults to 'name:asc' if omitted.
user	string	No	URI of the user whose event types to list. Provide either user or organization (exactly one is required). IMPORTANT: Must be the actual resolved user URI (e.g., https://api.calendly.com/users/5dc7b7a8-1d8c-4fcc-8b63-5f5a17eea4a3). The shorthand 'https://api.calendly.com/users/me' is NOT accepted — use the ‘Get Current User’ action first.
count	integer	No	Number of event types per page (max 100).
active	boolean	No	Filter by active status (true for active, false for inactive). If omitted, all event types are returned.
page_token	string	No	Token for retrieving the next or previous page of event types.
organization	string	No	URI of the organization whose event types to list. Provide either organization or user (exactly one is required).
admin_managed	boolean	No	Filter by admin management.
user_availability_schedule	string	No	URI of the user’s availability schedule. Example: 'https://api.calendly.com/user_availability_schedules/SCHEDULE_UUID'.

Output

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

List webhook subscriptions

CALENDLY_LIST_WEBHOOK_SUBSCRIPTIONS

Retrieves webhook subscriptions for a Calendly organization; scope determines if user or group URI is also required for filtering.

Input parameters

Name	Type	Required	Description
sort	string	No	Sort order for results (e.g., 'created_at:asc'). Supported fields: created_at, updated_at. Supported directions: asc, desc.
user	string	No	URI of the Calendly user; required if scope is 'user'.
count	integer	No	Number of results per page (maximum 100).
group	string	No	URI of the Calendly group; required if scope is 'group'.
scope	string	Yes	Scope of the webhook subscriptions: 'organization', 'user', or 'group'.
page_token	string	No	Token for paginating to the next or previous page of results.
organization	string	Yes	URI of the Calendly organization for which to list webhook subscriptions.

Output

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

Invite user to organization

CALENDLY_ORGANIZATION_INVITATION

Tool to invite a user to a Calendly organization via email. Use when you need to send an organization invitation to a new user. Requires organization owner or admin privileges.

Input parameters

Name	Type	Required	Description
email	string	Yes	The email address of the user to invite to the organization. An invitation email will be automatically sent to this address.
org_uuid	string	Yes	The unique identifier (UUID) of the organization to invite the user to.

Output

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

Create Event Invitee

CALENDLY_POST_INVITEE

Tool to create a new Event Invitee with standard notifications, calendar invites, reschedules, and workflows. Use when programmatically scheduling meetings via API. Requires paid Calendly plan (Standard+).

Input parameters

Name	Type	Required	Description
invitee	object	Yes	Details of the invitee being scheduled.
location	object	No	Meeting location configuration.
tracking	object	No	UTM and tracking parameters for marketing attribution.
event_type	string	Yes	URI reference to the event type being scheduled (e.g., 'https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA').
start_time	string	Yes	Start time of the scheduled event in ISO 8601 UTC format (e.g., '2025-12-16T10:00:00Z').
event_guests	array	No	List of email addresses for additional invitee guests (max 10).
questions_and_answers	array	No	Custom question responses from the booking form.

Output

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

Remove user from organization

CALENDLY_REMOVE_USER_FROM_ORGANIZATION

Removes a user (who is not an owner) from an organization by their membership UUID, requiring administrative privileges.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The UUID of the organization membership to remove. This is the unique identifier from the membership URI (e.g., from 'https://api.calendly.com/organization_memberships/UUID'). Get membership UUIDs by calling list_organization_memberships. Note: Cannot remove organization owners — use this for admin or user roles only.

Output

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

Revoke a user’s organization invitation

CALENDLY_REVOKE_USER_S_ORGANIZATION_INVITATION

Revokes a pending and revokable (not yet accepted or expired) organization invitation using its UUID and the organization’s UUID, rendering the invitation link invalid.

Input parameters

Name	Type	Required	Description
uuid	string	Yes	The unique identifier of the organization invitation to be revoked.
org_uuid	string	Yes	The unique identifier of the organization.

Output

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

Update Event Type

CALENDLY_UPDATE_EVENT_TYPE

Tool to update an existing one-on-one event type (kind: solo) in Calendly. Use when you need to modify event type settings such as name, duration, location, or description. NOTE: Currently only supports one-on-one event types.

Input parameters

Name	Type	Required	Description
name	string	No	The event type name that will be displayed to invitees.
uuid	string	Yes	Unique identifier (UUID) of the event type to update. Can be provided as either the full event type URI (e.g., 'https://api.calendly.com/event_types/AAAAAAAAAAAAAAAA') or just the UUID portion (e.g., 'AAAAAAAAAAAAAAAA').
color	string	No	Hexadecimal color value for the scheduling page. Must match pattern ^#[a-f\d]{6}$ (e.g., '#fff200').
active	boolean	No	Indicates if the event type is active and available for booking.
locale	string	No	Locale for the event type’s scheduling page language. Options: "de", "en", "es", "fr", "it", "nl", "pt", "uk".
duration	integer	No	Length of sessions in minutes. Must be between 1 and 720 minutes.
locations	array	No	Configuration information for each possible location where the event can take place.
description	string	No	The event type description that will be shown on the scheduling page (plain text format).
duration_options	array	No	Alternative duration choices for flexible meetings. Maximum 4 unique values allowed. Each must be between 1 and 720 minutes.

Output

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

Update Event Type Availability

CALENDLY_UPDATE_EVENT_TYPE_AVAILABILITY

Tool to update an event type availability schedule in Calendly. Use when you need to change the timezone or availability rules for an event type. WARNING: Updating rules will overwrite all existing rules — retrieve existing rules first using GET /event_type_availability_schedules.

Input parameters

Name	Type	Required	Description
user	string	No	URI of the user associated with the event type. Required when an admin or org owner is updating a specific user’s schedule.
event_type	string	Yes	URI of the event type whose availability schedule is to be updated. Must follow the pattern https://api.calendly.com/event_types/{uuid} and contain '/event_types/' in the path. Other Calendly URIs (e.g., user_availability_schedules, scheduling_links, users) are NOT valid for this field.
availability_rule	object	Yes	Availability rule configuration containing timezone and rules for when the event type is available. WARNING: Rules will overwrite all existing rules.
availability_setting	string	No	Indicates how availability is determined. Default: 'host'. Every host on the Event Type shares identical schedule.

Output

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