Calendly

Learn how to use Calendly with Composio

Overview

Enum

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
base_url
stringDefaults to https://api.calendly.com

Actions

Returns information about a specified group.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Get a specified routing form.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Invites a user to an organization.

Action Parameters

uuid
stringRequired
email
stringRequired

Action Response

data
object
successful
boolean
error

Get a list of webhook subscriptions for a specified organization or user.

Action Parameters

organization
stringRequired
user
string
group
string
page_token
string
count
integerDefaults to 20
sort
string
scope
stringRequired

Action Response

data
object
successful
boolean
error

Returns a list of groups.

Action Parameters

organization
stringRequired
page_token
string
count
integerDefaults to 20

Action Response

data
object
successful
boolean
error

Delete a webhook subscription.

Action Parameters

webhook_uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns the availability schedules of the given user.

Action Parameters

user
stringRequired

Action Response

data
object
successful
boolean
error

Removes a user from an organization. notes: * to remove users, the caller must have admin rights for the organization * an organization owner can’t be removed

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns information about a specified invitee (person invited to an event).

Action Parameters

event_uuid
stringRequired
invitee_uuid
stringRequired

Action Response

data
object
successful
boolean
error

> this endpoint requires an enterprise subscription. returns a list of activity log entries

Action Parameters

organization
stringRequired
search_term
string
actor
array
sort
arrayDefaults to ['occurred_at:desc']
min_occurred_at
string
max_occurred_at
string
page_token
string
count
integerDefaults to 20
namespace
array
action
array

Action Response

data
object
successful
boolean
error

Returns a group relationship by uuid

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns a list of invitees for an event.

Action Parameters

uuid
stringRequired
status
string
sort
stringDefaults to created_at:asc
email
string
page_token
string
count
integerDefaults to 20

Action Response

data
object
successful
boolean
error

Cancels specified event.

Action Parameters

uuid
stringRequired
reason
string

Action Response

data
object
successful
boolean
error

Get a specified webhook subscription.

Action Parameters

webhook_uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns information about a specified user.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns information about a specified event type.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

> this endpoint requires an enterprise subscription. returns a list of outgoing sms communications.

Action Parameters

organization
stringRequired
count
integerDefaults to 20
min_created_at
string
max_created_at
string
page_token
string

Action Response

data
object
successful
boolean
error

Get a list of routing forms for a specified organization.

Action Parameters

organization
stringRequired
count
integerDefaults to 20
page_token
string
sort
string

Action Response

data
object
successful
boolean
error

Returns an organization invitation that was sent to the organization’s members.

Action Parameters

org_uuid
stringRequired
uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns a list of group relationships - a given owner can have one membership record, but multiple admin records

Action Parameters

count
integerDefaults to 20
page_token
string
organization
string
owner
string
group
string

Action Response

data
object
successful
boolean
error

Returns a list of available times for an event type within a specified date range. date range can be no greater than 1 week (7 days). note: * this endpoint does not support traditional keyset pagination.

Action Parameters

event_type
stringRequired
start_time
stringRequired
end_time
stringRequired

Action Response

data
object
successful
boolean
error

Marks an invitee as a no show.

Action Parameters

invitee
string

Action Response

data
object
successful
boolean
error

This endpoint retrieves all event types linked to a particular user within an organization, requiring either organization or user as mandatory query parameters.

Action Parameters

active
boolean
organization
string
user
string
user_availability_schedule
string
sort
stringDefaults to name:asc
admin_managed
boolean
page_token
string
count
integerDefaults to 20

Action Response

data
object
successful
boolean
error

Returns information about a specified event.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

The api returns event lists, filtered by ‘organization’, ‘user’, or ‘group’. admin privileges are needed for organization/group filters. admins can also view events of a specific user or group within their org. users can view their personal events.

Action Parameters

user
string
organization
string
invitee_email
string
status
string
sort
string
min_start_time
string
max_start_time
string
page_token
string
count
integerDefaults to 20
group
string

Action Response

data
object
successful
boolean
error

Returns information about a specified invitee no show.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Fetch list of event type hosts

Action Parameters

event_type
stringRequired
count
integerDefaults to 20
page_token
string

Action Response

data
object
successful
boolean
error

Calendly’s “customize once and share” feature lets you tailor one-on-one events for each invitee without creating a new event type. unspecified parameters default to the original event settings.

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
object
successful
boolean
error

Fetches a week-max list of user events, both internal and external (if conflict check set), in ascending order without keyset pagination support.

Action Parameters

user
stringRequired
start_time
stringRequired
end_time
stringRequired

Action Response

data
object
successful
boolean
error

Enterprise subscription holders can use this endpoint to request deletion of scheduled events data within a past 24-month range; process may take up to 7 days.

Action Parameters

end_time
stringRequired
start_time
stringRequired

Action Response

data
object
successful
boolean
error

Returns basic information about your user account.

Action Parameters

Action Response

data
object
successful
boolean
error

The endpoint lists organization memberships for users and all users in an organization, and retrieves the organization uri, using user and organization options.

Action Parameters

page_token
string
count
integerDefaults to 20
email
string
organization
string
user
string

Action Response

data
object
successful
boolean
error

Returns a list of organization invitations that were sent to the organization’s members.

Action Parameters

uuid
stringRequired
count
integerDefaults to 20
page_token
string
sort
stringDefaults to created_at:asc
email
string
status
string

Action Response

data
object
successful
boolean
error

Undoes marking an invitee as a no show.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Webhook subscriptions can be created for organizations, users, or groups. organizational ones cover all events; user/group ones are entity-specific. some events support several scopes, so create subscriptions accordingly.

Action Parameters

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

Action Response

data
object
successful
boolean
error

This will return the availability schedule of the given uuid.

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Returns information about a user’s organization membership

Action Parameters

uuid
stringRequired

Action Response

data
object
successful
boolean
error

Creates one-off event type

Action Parameters

co_hosts
array
date_setting
objectRequired
duration
integerRequired
host
stringRequired
location
object
name
stringRequired
timezone
string

Action Response

data
object
successful
boolean
error

Use this to revoke an organization invitation to an organization. once revoked, the invitation link that was sent to the invitee is no longer valid.

Action Parameters

org_uuid
stringRequired
uuid
stringRequired

Action Response

data
object
successful
boolean
error

Use this endpoint with an enterprise subscription to request the removal of invitee data from past organization events. deletion may take up to a week.

Action Parameters

emails
arrayRequired

Action Response

data
object
successful
boolean
error