How to create Calendly OAuth2 credentials and configure it in Composio

In this guide, I’ll walk you through the process of customizing the auth config for Calendly. Let’s get started.

Setting up Calendly

In this section, we’ll go through the process of creating a Calendly OAuth application.

NOTE: If you already have a Calendly OAuth app and access to the Client ID and Client Secret, you can skip this section.

Step 1: Create a Calendly Developer App

1. Log in to your Calendly account.

2. Navigate to the Calendly Developer Portal:

https://developer.calendly.com/

3. Click My Apps.

4. Click Create New App.

Step 2: Register Your Calendly OAuth App

After clicking Create New App, you’ll be asked to fill in the following fields:

App Details

1. Name of app

Composio-Calendly

2. Kind of app

Select:

Web

3. Environment type

Choose based on your use case:

Sandbox

Use Sandbox for testing and development.

Switch to **Production**

4. Redirect URI

Enter the following redirect URL:

https://backend.composio.dev/api/v3/toolkits/auth/callback

Important requirements:

• Must use https

• No trailing slash

• Must exactly match the value used in Composio

Once created, Calendly will generate:

• Client ID

• Client Secret

Copy both values and store them securely, you’ll need them shortly.

Step 3: Configure Redirect URI

Ensure the following redirect URI is present in your Calendly app configuration:

https://backend.composio.dev/api/v3/toolkits/auth/callback

OAuth Scopes in Calendly

Calendly uses OAuth2 with explicit scopes to control API access.

Scopes define what resources your integration can access during the OAuth authorization flow.

Common Calendly OAuth Scopes

Calendly supports the following scopes:

• default → Access to the authenticated user’s Calendly data

• users:read → Read user profile information

• events:read → Read scheduled events

• event_types:read → Read event types

• webhook_subscriptions:write → Create and manage webhooks

The actual scopes you should request depend on your integration’s requirements.

Creating the Auth Config in Composio

With your OAuth credentials ready, navigate to the Composio dashboard:

https://platform.composio.dev/

Step 1: Create Auth Config

1. Click Create Auth Config

2. Select Calendly from the list of available toolkits

Step 2: Configure Authentication Type

1. Ensure authentication is set to OAuth2

2. Enable Use your own developer authentication

Step 3: Fill in Credentials

1. Open the Manage Auth Config tab

2. Paste:

   1. Client ID

   2. Client Secret

3. Click Create Calendly Auth Config

Scopes Supported by Composio

Below are the Calendly scopes supported by Composio. Add only the scopes required for your integration:

default
users:read
events:read
event_types:read
webhook_subscriptions:write

Base URL for Calendly

All Calendly API requests go through:

https://api.calendly.com/

Final Step

Once everything is set up:

1. Copy the Auth Config ID (starts with ac_)

2. Store it securely using your secret manager

3. Use it in your application code to authenticate Calendly via Composio