## Calendly integration

Integrating Calendly with Frontegg allows your application to authenticate users via OAuth 2.0 and interact with their Calendly accounts — reading event types, listing scheduled events, managing invitees, and creating webhook subscriptions on their behalf.

Prerequisites
- A Calendly account
- Access to the [Calendly Developer Console](https://developer.calendly.com/console/apps)


### Connect Calendly

#### Step 1: Open the Calendly developer portal

Navigate to [developer.calendly.com](https://developer.calendly.com/). Click **Log in / Sign up** in the top navigation bar.

![Calendly developer portal](/assets/calendly-1.8133346030dd9420ed21e516e7672a8d22601a83b7ac41b7640aed2319af69b3.1ce25488.png)

#### Step 2: Access My Apps

After signing in, you are redirected to the **My Apps** page at [developer.calendly.com/console/apps](https://developer.calendly.com/console/apps). This page lists all your existing OAuth applications.

![Calendly My Apps page](/assets/calendly-2.65fae68f7d2b828ef66c1cde94b513c285bbea1dbb325bda33c03e6967cdb72e.1ce25488.png)

#### Step 3: Create a new app

Click **Create new app**.

![Create new app button](/assets/calendly-3.66b0577351370a24f220e426246de50e7fc68afdbe4e9c95589dc336e24d7b2e.1ce25488.png)

#### Step 4: Fill in the app details

On the **Provide OAuth app details** form (Step 1 of 2), fill in the following fields:

- **Name of app**: Enter a name (for example, `Frontegg Integration`).
- **Redirect URI**: Enter the following URI:
`https://YOUR_MCP_GATEWAY_URL/integration-callback`
- **Kind of app**: Select **Web**.
- **Environment type**: Select **Production**.


Click **Next**.

![Calendly app details form](/assets/calendly-4.1f0acf7de3a78cdc322c4b940c11ee82635902f887c32c79e2fbbc2504092f62.1ce25488.png)

#### Step 5: Review the available scopes

On the **Choose scopes** step (Step 2 of 2), you see scopes grouped by category. Each scope controls what your app can access in the user's Calendly account.

![Calendly scopes selection](/assets/calendly-5.64748d705348f89288c1c5e9ccb22cdabd3319a8f5db93f57f9b50fee3081ba5.1ce25488.png)

#### Step 6: Select required scopes

Enable the following scopes for the Frontegg integration:

| Scope | Description |
|  --- | --- |
| `event_types:read` | Retrieve event type details and available times |
| `scheduled_events:read` | Retrieve scheduled events and event invitee information |
| `scheduled_events:write` | Create event invitees, cancel events, or mark invitees as no-show |
| `users:read` | Retrieve user information |
| `webhooks:read` | Retrieve webhook subscriptions and sample payloads |
| `webhooks:write` | Create or delete webhook subscriptions |


Click **Create**.

![Calendly scopes selected](/assets/calendly-6.02db22019520f4e51269d0a0d5fd79a303db48b84f9a83b29a70685a11dfa46b.1ce25488.png)

#### Step 7: Copy your credentials

After the app is created, you land on the credentials page. Copy the **Client ID** and **Client Secret** for use in the Frontegg portal.

Keep your credentials secure
The Client Secret is shown only once. Store it immediately in a secure location. Never share or commit it to version control.

![Calendly app credentials](/assets/calendly-7.86798ca4862608e9f7ed7b60f478a5b382a1606a4eb2364e33230453dc1bcd17.1ce25488.png)

### Configure the Frontegg portal

Once you have your **Client ID** and **Client Secret**, configure the integration in the Frontegg portal:

1. Open the **Frontegg portal** and navigate to **[ENVIRONMENT]** → **Integrations** → **Calendly**.
2. Enter the **Client ID** and **Client Secret** in the corresponding fields.
3. Select the required **scopes**.
4. Click **Save**.


### Additional resources

- [Calendly API documentation](https://developer.calendly.com/api-docs)
- [Calendly developer portal](https://developer.calendly.com/)
- [How to get your Redirect URL](/agen-for-work/connectors/redirect-url)