Calendly

Connect to Calendly. Access user profile, events, and scheduling workflows.

Supports authentication: OAuth 2.0

Set up the agent connector

Register your Scalekit environment with the Calendly connector so Scalekit handles the OAuth flow and token lifecycle for your users. Follow every step below from start to finish — by the end you will have a working connection.

1. Create a Calendly OAuth application

   You need a Calendly OAuth app to get the Client ID and Client Secret that Scalekit will use to authorize your users.

   Go to the Calendly Developer Portal:

   • Open developer.calendly.com in your browser.
   • Click Log In at the top right and sign in with your Calendly account (the same account you use to log in to calendly.com).
   • After signing in, you land on the developer portal home page.

   Create a new app:

   • In the top navigation bar, click My Apps.

   • Click the Create New App button (top right of the page).

   • Fill in the form:

     Field	What to enter
     App Name	A recognizable name for your integration, e.g. My AI Scheduling Agent
     App Description	Brief description, e.g. AI agent for managing scheduling
     Homepage URL	Your app’s public URL. For testing you can use https://localhost
     Grant Type	Select Authorization Code — this is required for OAuth 2.0

   • Leave Redirect URIs blank for now. You will add it in the next step.

   • Click Create App.

   After the app is created, Calendly takes you to the app’s OAuth Settings page. Keep this tab open.

   

   Tip

   Any Calendly account can create OAuth apps. API access and available scopes depend on your Calendly plan — Enterprise features such as activity logs require an Enterprise plan.

2. Copy the redirect URI from Scalekit

   Scalekit gives you a callback URL that Calendly will redirect users back to after they authorize your app. You need to register this URL in your Calendly OAuth app.

   In the Scalekit dashboard:

   • Go to app.scalekit.com and sign in.
   • In the left sidebar, click Agent Auth.
   • Click Create Connection.
   • Search for Calendly and click Create.
   • A connection details panel opens. Find the Redirect URI field — it looks like:

     https://<YOUR_ENV>.scalekit.cloud/sso/v1/oauth/conn_<ID>/callback

   • Click the copy icon next to the Redirect URI to copy it to your clipboard.

   

3. Register the redirect URI in Calendly

   Switch back to the Calendly Developer Portal tab you left open.

   • Make sure you are on the OAuth Settings page of your app.
   • Scroll down to the Redirect URIs section.
   • Click in the text box and paste the redirect URI you copied from Scalekit.
   • Click Add URI — the URI appears in the list above the input box.
   • Click Save Changes at the bottom of the page.

   

   Caution

   The redirect URI must match character-for-character — including the https:// prefix, the full domain, and the exact path. Any mismatch will cause the OAuth flow to fail with a redirect_uri_mismatch error.

4. Enable OAuth scopes

   Scopes control which Calendly API resources your app can access on behalf of the user. You must enable the same scopes in your Calendly app that you will request in Scalekit.

   • On the OAuth Settings page, scroll to the Scopes section.

   • Check the box next to each scope you need:

     Scope	Access granted	Plan required
     default	User profile, event types, scheduled events, availability	All plans
     activity_log:read	Audit log entries (read-only)	Enterprise only

   • For most integrations, checking default is sufficient.

   • Click Save Changes.

   Tip

   Only enable scopes your integration actually uses. Users see a list of requested permissions on the authorization screen — fewer scopes increases trust and approval rates.

5. Copy your Client ID and Client Secret

   Still on the OAuth Settings page in Calendly:

   • Scroll to the OAuth Credentials section at the top.
   • Client ID — this is shown in plain text. Click Copy ID to copy it.
   • Client Secret — click Reveal to show the secret, then copy it.

   Paste both values somewhere safe (a password manager or secrets vault). You will enter them into Scalekit in the next step.

   Caution

   Never commit your Client Secret to source control. If it is ever exposed, click Regenerate Secret in the Calendly portal immediately — this invalidates the old secret and all existing connections will stop working until you update them in Scalekit.

6. Add credentials in Scalekit

   Switch back to the Scalekit dashboard tab.

   • Go to Agent Auth → Connections and click the Calendly connection you created in Step 2.

   • Fill in the credentials form:

     Field	Value
     Client ID	Paste the Client ID from Step 5
     Client Secret	Paste the Client Secret from Step 5
     Permissions	Enter the scopes you enabled in Step 4, e.g. default

   • Click Save.

   

   Your Calendly connection is now configured. Scalekit will use these credentials to run the OAuth flow whenever a user connects their Calendly account.

   Tip

   The scopes entered here must match exactly what you enabled in Calendly. A mismatch causes an invalid_scope error when users try to authorize. If you add more scopes later, update both your Calendly app and this Scalekit connection.

Usage

Connect a user’s Calendly account and make API calls on their behalf — Scalekit handles OAuth and token management automatically.

Proxy API Calls

Node.js

import { ScalekitClient } from '@scalekit-sdk/node';
import 'dotenv/config';

const connectionName = 'calendly'; // get your connection name from connection configurations
const identifier = 'user_123';     // your unique user identifier

// Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
const scalekit = new ScalekitClient(
  process.env.SCALEKIT_ENV_URL,
  process.env.SCALEKIT_CLIENT_ID,
  process.env.SCALEKIT_CLIENT_SECRET
);
const actions = scalekit.actions;

// Authenticate the user
const { link } = await actions.getAuthorizationLink({
  connectionName,
  identifier,
});
console.log('🔗 Authorize Calendly:', link);
process.stdout.write('Press Enter after authorizing...');
await new Promise(r => process.stdin.once('data', r));

// Make a request via Scalekit proxy
const result = await actions.request({
  connectionName,
  identifier,
  path: '/users/me',
  method: 'GET',
});
console.log(result);

Python

import scalekit.client, os
from dotenv import load_dotenv
load_dotenv()

connection_name = "calendly"  # get your connection name from connection configurations
identifier = "user_123"       # your unique user identifier

# Get your credentials from app.scalekit.com → Developers → Settings → API Credentials
scalekit_client = scalekit.client.ScalekitClient(
    client_id=os.getenv("SCALEKIT_CLIENT_ID"),
    client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
    env_url=os.getenv("SCALEKIT_ENV_URL"),
)
actions = scalekit_client.actions

# Authenticate the user
link_response = actions.get_authorization_link(
    connection_name=connection_name,
    identifier=identifier
)
# present this link to your user for authorization, or click it yourself for testing
print("🔗 Authorize Calendly:", link_response.link)
input("Press Enter after authorizing...")

# Make a request via Scalekit proxy
result = actions.request(
    connection_name=connection_name,
    identifier=identifier,
    path="/users/me",
    method="GET"
)
print(result)

Tool list

calendly_activity_log_list

Returns a list of activity log entries for a Calendly organization. Requires Enterprise plan.

Name	Type	Required	Description
action	string	No	Filter by action type (e.g. user.created, event_type.updated).
actor	string	No	Filter by actor user URI.
count	integer	No	Number of results per page (max 100).
max_occurred_at	string	No	Filter entries occurring before this time (ISO 8601).
min_occurred_at	string	No	Filter entries occurring at or after this time (ISO 8601).
organization	string	Yes	Organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.
sort	string	No	Sort field and direction, e.g. occurred_at:asc or occurred_at:desc.

calendly_current_user_get

Returns the profile of the currently authenticated Calendly user.

calendly_data_compliance_events_delete

Deletes all Calendly event data within the specified time range for compliance purposes. This is a destructive operation.

Name	Type	Required	Description
end_time	string	Yes	End of the time range for event data deletion in ISO 8601 format.
start_time	string	Yes	Start of the time range for event data deletion in ISO 8601 format.

calendly_data_compliance_invitees_delete

Deletes all Calendly invitee data for the specified email addresses for compliance purposes. This is a destructive operation.

Name	Type	Required	Description
emails	array<string>	Yes	Array of invitee email addresses whose data should be deleted.

calendly_event_invitee_get

Returns the details of a specific invitee for a scheduled Calendly event.

Name	Type	Required	Description
event_uuid	string	Yes	The UUID of the scheduled event.
invitee_uuid	string	Yes	The UUID of the invitee.

calendly_event_invitees_list

Returns a list of invitees for a specific scheduled Calendly event.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
email	string	No	Filter invitees by email address.
page_token	string	No	Token for fetching the next page of results.
status	string	No	Filter invitees by status: active or canceled.
uuid	string	Yes	The UUID of the scheduled event.

calendly_event_type_availability_schedules_list

Returns a list of availability schedules for the specified Calendly event type.

Name	Type	Required	Description
event_type	string	Yes	The URI of the event type, e.g. https://api.calendly.com/event_types/xxx.
user	string	No	The URI of the user to filter schedules by, e.g. https://api.calendly.com/users/xxx.

calendly_event_type_availability_schedules_update

Updates the availability schedules (rules) for the specified Calendly event type.

Name	Type	Required	Description
event_type	string	Yes	The URI of the event type whose availability schedules to update, e.g. https://api.calendly.com/event_types/xxx.
rules	array<object>	Yes	Array of availability rule objects. Each rule has type, intervals, and wday fields.
timezone	string	No	Timezone for the availability rules (e.g. America/New_York).

calendly_event_type_available_times_list

Returns available scheduling times for a specific event type within a given date range.

Name	Type	Required	Description
end_time	string	Yes	End of the availability window in ISO 8601 format.
event_type	string	Yes	Full URI of the event type, e.g. https://api.calendly.com/event_types/{uuid}.
start_time	string	Yes	Start of the availability window in ISO 8601 format.

calendly_event_type_create

Creates a new event type in a Calendly organization for a specified host.

Name	Type	Required	Description
color	string	No	Hex color code for the event type, e.g. ‘#FF5733’.
description	string	No	Optional description of the event type.
duration	integer	Yes	Duration of the event in minutes.
host	string	Yes	The URI of the user who will host this event type, e.g. https://api.calendly.com/users/xxx.
name	string	Yes	Name of the event type.
organization	string	Yes	The URI of the organization this event type belongs to, e.g. https://api.calendly.com/organizations/xxx.

calendly_event_type_get

Returns the details of a specific Calendly event type by its UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the event type.

calendly_event_type_memberships_list

Returns a list of memberships (hosts) associated with the specified Calendly event type.

Name	Type	Required	Description
count	integer	No	Number of results to return per page.
event_type	string	Yes	The URI of the event type, e.g. https://api.calendly.com/event_types/xxx.
page_token	string	No	Token for paginating to the next set of results.

calendly_event_type_update

Updates an existing Calendly event type. Only the fields provided will be updated.

Name	Type	Required	Description
color	string	No	Hex color code for the event type, e.g. ‘#FF5733’.
description	string	No	Updated description for the event type.
duration	integer	No	Updated duration of the event in minutes.
name	string	No	Updated name of the event type.
uuid	string	Yes	The UUID of the event type to update.

calendly_event_types_list

Returns a list of event types for a user or organization. Provide either user or organization URI.

Name	Type	Required	Description
active	boolean	No	If true, only return active event types.
count	integer	No	Number of results to return per page (max 100).
organization	string	No	Filter by organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.
user	string	No	Filter by user URI, e.g. https://api.calendly.com/users/{uuid}.

calendly_group_get

Returns a single Calendly group record by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the group to retrieve.

calendly_group_relationship_get

Returns a single Calendly group relationship record by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the group relationship to retrieve.

calendly_group_relationships_list

Returns a list of group relationships in the specified Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results to return per page.
organization	string	Yes	The URI of the organization whose group relationships to list, e.g. https://api.calendly.com/organizations/xxx.
page_token	string	No	Token for paginating to the next set of results.

calendly_groups_list

Returns a list of groups in the specified Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results to return per page. Default is 20.
organization	string	Yes	The URI of the organization whose groups to list, e.g. https://api.calendly.com/organizations/xxx.
page_token	string	No	Token for paginating to the next set of results.
sort	string	No	Sort order for the results, e.g. ‘created_at:asc’ or ‘created_at:desc’.

calendly_invitee_create

Creates a new invitee for a scheduled Calendly event.

Name	Type	Required	Description
email	string	Yes	Email address of the invitee.
event	string	Yes	The URI of the scheduled event to add this invitee to, e.g. https://api.calendly.com/scheduled_events/xxx.
name	string	Yes	Full name of the invitee.
timezone	string	No	IANA timezone string for the invitee, e.g. ‘America/New_York’.

calendly_invitee_no_show_create

Marks a specific invitee as a no-show for a scheduled Calendly event.

Name	Type	Required	Description
invitee	string	Yes	The full URI of the invitee, e.g. https://api.calendly.com/scheduled_events/{event_uuid}/invitees/{invitee_uuid}.

calendly_invitee_no_show_delete

Removes the no-show mark from an invitee on a scheduled Calendly event.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the invitee no-show record.

calendly_invitee_no_show_get

Returns a specific invitee no-show record by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the invitee no-show record.

calendly_locations_list

Returns a list of meeting locations available in the specified Calendly organization or for a specific user.

Name	Type	Required	Description
count	integer	No	Number of results to return per page.
organization	string	No	The URI of the organization to filter locations by, e.g. https://api.calendly.com/organizations/xxx.
page_token	string	No	Token for paginating to the next set of results.
user	string	Yes	The URI of the user to filter locations by, e.g. https://api.calendly.com/users/xxx.

calendly_one_off_event_type_create

Creates a one-off event type in Calendly with a specific date, host, and optional co-hosts.

Name	Type	Required	Description
co_hosts	array<string>	No	Array of user URIs for co-hosts, e.g. [‘https://api.calendly.com/users/xxx’].
date_setting	object	Yes	Object defining the date setting for the one-off event. Must include ‘type’ (e.g. ‘date_range’) and ‘start_date’/‘end_date’ or ‘date’.
description	string	No	Optional description for the one-off event type.
duration	integer	Yes	Duration of the event in minutes.
host	string	Yes	The URI of the user who will host this event type, e.g. https://api.calendly.com/users/xxx.
location	object	No	Optional location object, e.g. {"kind": "physical", "location": "123 Main St"}.
name	string	Yes	Name of the one-off event type.

calendly_organization_get

Returns the details of a specific Calendly organization by its UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the organization.

calendly_organization_invitation_create

Sends an invitation for a user to join a Calendly organization.

Name	Type	Required	Description
email	string	Yes	Email address of the user to invite.
uuid	string	Yes	The UUID of the organization.

calendly_organization_invitation_get

Returns the details of a specific invitation sent to join a Calendly organization.

Name	Type	Required	Description
org_uuid	string	Yes	The UUID of the organization that sent the invitation.
uuid	string	Yes	The UUID of the invitation to retrieve.

calendly_organization_invitation_revoke

Revokes a pending invitation to a Calendly organization.

Name	Type	Required	Description
invitation_uuid	string	Yes	The UUID of the invitation to revoke.
org_uuid	string	Yes	The UUID of the organization.

calendly_organization_invitations_list

Returns a list of pending invitations for a Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
email	string	No	Filter by invitee email address.
page_token	string	No	Token for fetching the next page of results.
status	string	No	Filter by invitation status: pending, accepted, or declined.
uuid	string	Yes	The UUID of the organization.

calendly_organization_membership_delete

Removes a user from a Calendly organization by deleting their membership.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the organization membership to remove.

calendly_organization_membership_get

Returns details of a specific organization membership by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the organization membership.

calendly_organization_memberships_list

Returns a list of organization memberships. Filter by organization URI or user URI.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
email	string	No	Filter by member email address.
organization	string	No	Filter by organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.
user	string	No	Filter by user URI, e.g. https://api.calendly.com/users/{uuid}.

calendly_outgoing_communications_list

Returns a list of outgoing communications (emails and notifications) for the specified Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results to return per page.
organization	string	Yes	The URI of the organization whose outgoing communications to list, e.g. https://api.calendly.com/organizations/xxx.
page_token	string	No	Token for paginating to the next set of results.
sort	string	No	Sort order for the results, e.g. ‘created_at:asc’ or ‘created_at:desc’.

calendly_routing_form_get

Returns the details of a specific Calendly routing form by its UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the routing form.

calendly_routing_form_submission_get

Returns the details of a specific routing form submission by its UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the routing form submission.

calendly_routing_form_submission_get_by_uuid

Returns a single routing form submission by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the routing form submission to retrieve.

calendly_routing_form_submissions_list

Returns a list of all routing form submissions across the specified Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results.
form	string	Yes	The URI of the routing form to list submissions for.
page_token	string	No	Token for next page.

calendly_routing_forms_list

Returns a list of routing forms for a Calendly organization.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
organization	string	Yes	Organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.

calendly_sample_webhook_data_get

Returns a sample webhook payload for the specified event type, useful for testing webhook integrations.

Name	Type	Required	Description
event	string	Yes	The webhook event type to get sample data for, e.g. ‘invitee.created’.
organization	string	Yes	The URI of the organization, e.g. https://api.calendly.com/organizations/xxx.
scope	string	Yes	The scope of the webhook, either ‘organization’ or ‘user’.
user	string	No	The URI of the user, required when scope is ‘user’, e.g. https://api.calendly.com/users/xxx.

calendly_scheduled_event_cancel

Cancels a scheduled Calendly event. Optionally includes a reason for cancellation.

Name	Type	Required	Description
reason	string	No	Optional reason for the cancellation.
uuid	string	Yes	The UUID of the scheduled event to cancel.

calendly_scheduled_event_get

Returns the details of a specific scheduled event by its UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the scheduled event.

calendly_scheduled_events_list

Returns a list of scheduled events for a user or organization, with optional time range and status filters.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
max_start_time	string	No	Filter events starting before this time (ISO 8601).
min_start_time	string	No	Filter events starting at or after this time (ISO 8601).
organization	string	No	Filter by organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.
sort	string	No	Sort field and direction, e.g. start_time:asc or start_time:desc.
status	string	No	Filter by event status: active or canceled.
user	string	No	Filter by user URI, e.g. https://api.calendly.com/users/{uuid}.

calendly_scheduling_link_create

Creates a single-use or limited-use scheduling link for a specified Calendly event type.

Name	Type	Required	Description
max_event_count	integer	Yes	Maximum number of events that can be booked using this scheduling link.
owner	string	Yes	The URI of the event type that owns this scheduling link, e.g. https://api.calendly.com/event_types/xxx.
owner_type	string	Yes	The type of owner for the scheduling link. Use ‘EventType’.

calendly_share_create

Creates a shareable scheduling page for a Calendly event type with optional customizations like duration, date range, and availability rules.

Name	Type	Required	Description
availability_rule	object	No	Optional availability rule object to override default scheduling availability.
duration	integer	No	Override event duration in minutes for this share.
end_date	string	No	The end date (YYYY-MM-DD) after which the share will no longer accept bookings.
event_type	string	Yes	The URI of the event type to create a share for, e.g. https://api.calendly.com/event_types/xxx.
hide_location	boolean	No	Whether to hide the event location from the scheduling page.
max_booking_time	integer	No	Maximum number of days in the future that can be booked via this share.
name	string	No	Custom name for this share.
start_date	string	No	The start date (YYYY-MM-DD) from which the share will accept bookings.

calendly_user_availability_schedule_get

Returns a single availability schedule for a Calendly user by UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the availability schedule to retrieve.

calendly_user_availability_schedules_list

Returns a list of availability schedules for the specified Calendly user.

Name	Type	Required	Description
user	string	Yes	The URI of the user whose availability schedules to list, e.g. https://api.calendly.com/users/xxx.

calendly_user_busy_times_list

Returns a list of busy time blocks for a Calendly user within the specified time range.

Name	Type	Required	Description
end_time	string	Yes	End of the time range in ISO 8601 format.
start_time	string	Yes	Start of the time range in ISO 8601 format.
user	string	Yes	The URI of the user whose busy times to list, e.g. https://api.calendly.com/users/xxx.

calendly_user_get

Returns the profile of a specific Calendly user by their UUID.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the user.

calendly_webhook_subscription_create

Creates a new webhook subscription to receive Calendly event notifications at a callback URL.

Name	Type	Required	Description
events	string	Yes	JSON array of event names to subscribe to, e.g. [“invitee.created”,“invitee.canceled”].
organization	string	Yes	Organization URI to scope the subscription.
scope	string	Yes	Scope of the webhook: user or organization.
signing_key	string	No	Optional signing key used to sign webhook payloads for verification.
url	string	Yes	The HTTPS callback URL that will receive webhook payloads.
user	string	No	User URI if scope is user-level.

calendly_webhook_subscription_delete

Deletes a Calendly webhook subscription, stopping future event notifications.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the webhook subscription to delete.

calendly_webhook_subscription_get

Returns the details of a specific Calendly webhook subscription.

Name	Type	Required	Description
uuid	string	Yes	The UUID of the webhook subscription.

calendly_webhook_subscriptions_list

Returns a list of webhook subscriptions for a user or organization.

Name	Type	Required	Description
count	integer	No	Number of results per page (max 100).
organization	string	No	Filter by organization URI, e.g. https://api.calendly.com/organizations/{uuid}.
page_token	string	No	Token for fetching the next page of results.
scope	string	No	Filter by webhook scope: user or organization.
user	string	No	Filter by user URI, e.g. https://api.calendly.com/users/{uuid}.