Calendly

Learn how to use Calendly with Composio

Overview

SLUG

CALENDLY

Description

Calendly is an appointment scheduling tool that automates meeting invitations, availability checks, and reminders, helping individuals and teams avoid email back-and-forth

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
string
full
stringDefaults to https://api.calendly.com
bearer_token
string

Tools

SLUG: CALENDLY_GET_USER

Retrieves comprehensive details for an existing calendly user.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_CANCEL_EVENT

Permanently cancels an existing, active scheduled event by its `uuid`, optionally providing a `reason`, which may trigger notifications to invitees.

Action Parameters

reason
string
uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_CREATE_INVITEE_NO_SHOW

Marks an invitee, identified by their existing and valid uri, as a 'no show' for a scheduled event.

Action Parameters

invitee
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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`.

Action Parameters

date_setting
objectRequired
duration
integerRequired
host
stringRequired
location
object
name
stringRequired
only_weekdays
boolean
timezone
stringDefaults to UTC

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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.

Action Parameters

availability__rule__rules
array
availability__rule__timezone
string
duration
integer
duration_options
array
end_date
string
event_type
stringRequired
hide_location
boolean
location_configurations
array
max_booking_time
integer
name
string
period_type
string
start_date
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_CREATE_WEBHOOK_SUBSCRIPTION

Creates a calendly webhook subscription to notify a specified `url` (which must be a publicly accessible https endpoint) for selected `events` within a given `organization` and `scope`.

Action Parameters

events
arrayRequired
group
string
organization
stringRequired
scope
stringRequired
signing_key
string
url
stringRequired
user
string

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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).

Action Parameters

emails
arrayRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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 <= `end time`); actual data deletion may take up to 7 days to complete.

Action Parameters

end_time
stringRequired
start_time
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_DELETE_WEBHOOK_SUBSCRIPTION

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

Action Parameters

webhook_uuid
stringRequired

Action Response

data
object
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_CURRENT_USER

Retrieves detailed information about the currently authenticated calendly user.

Action Parameters

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_EVENT

Use to retrieve a specific calendly scheduled event by its uuid, provided the event exists in the user's calendly account.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_EVENT_INVITEE

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

Action Parameters

event_uuid
stringRequired
invitee_uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_GROUP

Retrieves all attributes of a specific calendly group by its uuid; the group must exist.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_GROUP_RELATIONSHIP

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

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: 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.

Action Parameters

uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: CALENDLY_GET_ORGANIZATION_INVITATION

Retrieves a specific calendly organization invitation using its uuid and the parent organization's uuid.

Action Parameters

org_uuid
stringRequired
uuid
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired