> ## Documentation Index
> Fetch the complete documentation index at: https://docs.runalloy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Calendly

> Integration details and setup guide for the Calendly connector in Alloy Automation.

## Pre-Built Tooling

| Category                            | Details                                                                                    |
| ----------------------------------- | ------------------------------------------------------------------------------------------ |
| **Authentication**                  | OAuth 2.0 (Authorization Code with refresh tokens) or Bearer Token (Personal Access Token) |
| **Two-Way Sync**                    | Yes                                                                                        |
| **Events Supported**                | Yes (Webhooks)                                                                             |
| **Realtime**                        | Yes                                                                                        |
| **Supports Rate Limiting**          | Yes (1000 requests per hour)                                                               |
| **Authentication Scopes Supported** | Single scope with full API access                                                          |

***

## Objects Supported

Alloy Automation supports syncing the following objects from **Calendly**:

* **Event Types** (Meeting types and configurations)
* **Scheduled Events** (Booked meetings)
* **Invitees** (Event attendees)
* **Users**
* **Organizations**
* **Webhooks**
* **Routing Forms**
* **Data Compliance** (GDPR deletion requests)
* **Activity Log**

***

## Set Up Guide

### Trial Access

| Question                                           | Answer                                                                                                                 |
| -------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Offers free trial?**                             | Yes. Calendly offers a free Basic plan with limited features. Sign up at [https://calendly.com](https://calendly.com). |
| **Requires requires paid sandbox**                 | No paid sandbox required. You can test with your free or trial account.                                                |
| **Requires partnership to obtain authentication?** | No. OAuth credentials and personal access tokens can be obtained directly from your Calendly account settings.         |

***

### Authentication (OAuth 2.0 or Bearer Token)

#### Option 1: OAuth 2.0 (Recommended for user-facing integrations)

For customers who want to completely whitelabel their OAuth experience, you can provide your own developer keys instead of using Alloy Automation's.

1. Log in to your **Calendly account** and navigate to **Integrations** → **API & Webhooks**.
2. Click **Register New App** to create an OAuth application.
3. Configure your OAuth application:
   * Add the redirect URI: [https://api.runalloy.com/api/strategy/connector/calendly/callback](https://api.runalloy.com/api/strategy/connector/calendly/callback)
   * Calendly uses a simplified scope model with full API access
4. Copy your **Client ID** and **Client Secret**.
5. Enter your **Client ID** and **Client Secret** into Alloy Automation.

#### Option 2: Bearer Token (Personal Access Token)

1. Log in to your **Calendly account** and go to **Integrations** → **API & Webhooks**.
2. Navigate to the **Personal Access Tokens** section and click **Generate New Token**.
3. Give your token a descriptive name and copy the generated token.
4. Enter the token into Alloy Automation as a Bearer token.

#### OAuth Authorization URL

The authorization URL for Calendly is: [https://auth.calendly.com/oauth/authorize](https://auth.calendly.com/oauth/authorize)

#### API Documentation

For detailed API documentation, visit: [https://developer.calendly.com/api-docs](https://developer.calendly.com/api-docs)

***

## Use Cases

### 1) Automated event synchronization

Sync scheduled Calendly events to your CRM, calendar system, or project management tool, ensuring your team has visibility into all booked meetings without manual entry.

### 2) Invitee data enrichment

Automatically pull invitee information from Calendly into your marketing automation or customer database, enriching contact records with meeting attendance and scheduling behavior.

### 3) Real-time booking notifications

Use Calendly webhooks to trigger instant notifications, reminder workflows, or preparation tasks when new meetings are booked, canceled, or rescheduled.

### 4) Event type management

Programmatically create, update, or manage Calendly event types based on team availability, campaign requirements, or seasonal scheduling needs, maintaining consistent booking options across your organization.

### 5) Analytics and reporting

Pull scheduling data, no-show rates, and booking patterns from Calendly into your business intelligence platform for comprehensive analysis of meeting efficiency and customer engagement.

***

## API Gotchas

* ⚠️ **Rate limiting:** Calendly enforces a rate limit of 1000 requests per hour per organization. Monitor usage and implement request throttling to avoid hitting limits.
* ⚠️ **Organization scope:** Most API requests require an organization URI. Ensure you obtain and use the correct organization identifier for your API calls.
* ⚠️ **Webhook event payloads:** Calendly webhooks contain minimal data in the payload. You'll typically need to make follow-up API calls to retrieve complete event or invitee details.

> For questions or troubleshooting, contact **[support@runalloy.com](mailto:support@runalloy.com)**.