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

# Calendly

> Let your UnleashX agent check Calendly availability, list events, and create scheduling links.

# Calendly

> **In one line:** Connect Calendly so your UnleashX agent can see your upcoming events, check when you're free or busy, and generate booking links automatically.

|                    |                                                                                                        |
| ------------------ | ------------------------------------------------------------------------------------------------------ |
| **Category**       | Productivity                                                                                           |
| **Authentication** | OAuth / Personal Access Token                                                                          |
| **Setup time**     | \~5 minutes                                                                                            |
| **Difficulty**     | Easy                                                                                                   |
| **Best for**       | Anyone who wants their agent to surface their schedule and hand out booking links during conversations |

## 1. Overview

Calendly is a scheduling tool that lets people book time with you based on your real availability. You set up event types (like "15-minute call"), and invitees pick a slot from a shareable link.

Once connected, your UnleashX agent can list your upcoming and past events, look up event details, check your availability and busy times, browse your event types, and create scheduling links on the fly. That means your agent can answer "when are you free?" and send a booking link without you lifting a finger.

Connecting Calendly to UnleashX is useful for sales, support, and customer-facing teams who want to keep scheduling moving inside a live call or chat.

## 2. What you'll need

* A Calendly account.
* At least one **event type** configured so there's something to share or book.
* A Calendly **Personal Access Token** (or an OAuth connection).

<Note>
  Personal Access Tokens are available on Calendly's paid plans (Standard and above). If you're on the free plan or don't see the API section, ask your account owner to enable it or upgrade.
</Note>

## 3. Get your credentials

Calendly uses a **Personal Access Token** (or OAuth).

<Steps>
  <Step title="Open Calendly Integrations">
    Sign in at [https://calendly.com](https://calendly.com), then go to **Account → Integrations & apps**. (Direct link: [https://calendly.com/integrations/api\_webhooks](https://calendly.com/integrations/api_webhooks))
  </Step>

  <Step title="Go to API & webhooks">
    Open the **API & webhooks** section.
  </Step>

  <Step title="Generate a Personal Access Token">
    Click **Generate new token**, name it `UnleashX`, and create it.
  </Step>

  <Step title="Copy the token">
    Copy the generated token.

    <Warning>
      The Personal Access Token is shown only once. Copy it now — if you lose it, revoke it and generate a new one.
    </Warning>
  </Step>
</Steps>

**What the token can access**

| Scope / Access                 | Why UnleashX needs it                             |
| ------------------------------ | ------------------------------------------------- |
| Read scheduled events          | To list and show your upcoming and past meetings  |
| Read event types               | To know what can be booked and via which link     |
| Read availability / busy times | To answer "when are you free?" accurately         |
| Create scheduling links        | To generate single-use booking links for invitees |

<Note>
  A Personal Access Token reflects your Calendly account's access. UnleashX only calls the endpoints needed for the tools listed in Section 5.
</Note>

## 4. Connect on UnleashX

<Steps>
  <Step title="Open your agent">
    Go to [https://www.tryunleashx.com](https://www.tryunleashx.com) and open the agent you want to connect.
  </Step>

  <Step title="Open Data Connectors">
    In the agent, go to **Data Connectors**.
  </Step>

  <Step title="Find Calendly">
    Locate **Calendly** in the list and click **Connect** / **Add** / **Configure**.
  </Step>

  <Step title="Authenticate">
    Either complete the OAuth flow or paste your **Personal Access Token**. UnleashX sends it as the `calendly_access_token` header (Bearer).
  </Step>

  <Step title="Confirm success">
    Save. When the status shows a **Connected** badge, your agent can start working with Calendly.
  </Step>
</Steps>

### Use Calendly in a Workflow

Once connected, you can add **Calendly** to any automation from the **Workflows** builder. Its triggers and tools appear in the Apps panel, marked with an **MCP** badge.

<Steps>
  <Step title="Add a trigger or action node">
    Open **Workflows → New Workflow**. On the canvas, click **+ Add Trigger** (or the **+** below any node) to add a step.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/05-add-trigger.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=449a0c03b0c7b40e571ec02373a85259" alt="Add a trigger on the workflow canvas" width="1390" height="722" data-path="images/mcp/workflows/05-add-trigger.png" />
  </Step>

  <Step title="Pick Calendly from the Apps panel">
    In the **Paths** panel, open the **Apps** tab and select **Calendly**. Use the search box if you have many connectors.

    <img src="https://mintcdn.com/unleashx/LXZeho1M8XzFkz0k/images/mcp/workflows/06-apps-list.png?fit=max&auto=format&n=LXZeho1M8XzFkz0k&q=85&s=bbb8bb6e668c4f8e1f6fd5e4955a45f0" alt="Choose your app from the Apps list" width="2446" height="1550" data-path="images/mcp/workflows/06-apps-list.png" />
  </Step>

  <Step title="Choose a trigger or tool">
    Pick the trigger or action you want. Configure its fields — required fields are marked with a red asterisk (\*).
  </Step>

  <Step title="Add or select your account">
    Under **Selected account**, choose an already-connected account, or click **Add Account** to connect one now.
  </Step>

  <Step title="Save and test">
    Fill in the remaining fields and click **Save**. Use **Test** to verify the step, then toggle **Publish** when the workflow is ready.
  </Step>
</Steps>

<Note>
  The steps are the same for every connector. For the full workflow builder guide, see [Using MCP in Workflows](/mcp/workflows).
</Note>

## 5. Available tools

| Tool                   | What it does                           | Changes data? |
| ---------------------- | -------------------------------------- | ------------- |
| List Upcoming Events   | Lists your upcoming scheduled events   | No            |
| Get Event Details      | Gets details of a single event         | No            |
| Search Events          | Searches your scheduled events         | No            |
| Check Availability     | Checks your available time slots       | No            |
| Get Busy Times         | Gets the times you're already booked   | No            |
| List Event Types       | Lists your event types                 | No            |
| Get Event Type Details | Gets details of a single event type    | No            |
| Create Scheduling Link | Creates a single-use scheduling link   | ✏️ Yes        |
| Create Booking         | Creates a booking (schedules an event) | ✏️ Yes        |

## 6. Example usage

**"What meetings do I have coming up this week?"**
Behind the scenes: List Upcoming Events (and Get Event Details for specifics).

**"Send this prospect a link to book a 30-minute demo."**
Behind the scenes: List Event Types → Create Scheduling Link.

## 7. Permissions & data access

**UnleashX CAN:**

* Read your scheduled events and event details.
* Read your event types and availability/busy times.
* Create scheduling links and bookings.

**UnleashX CANNOT:**

* Access another user's Calendly account.
* Change Calendly account, billing, or team settings.
* Act beyond what your token's account can do.

**To disconnect:** In UnleashX, open your agent → **Data Connectors** → **Calendly** → **Disconnect**. To fully revoke access, delete the token in Calendly's **API & webhooks** page (or revoke the OAuth app). Either action stops access immediately.

## 8. Troubleshooting

| Problem               | What it means                             | How to fix it                                                  |
| --------------------- | ----------------------------------------- | -------------------------------------------------------------- |
| `401 Unauthorized`    | The token is wrong, expired, or revoked   | Generate a new Personal Access Token and reconnect in UnleashX |
| `403 Forbidden`       | Your plan or account lacks API access     | Confirm you're on a plan that includes the API, then retry     |
| `404 Not Found`       | The event or event type URI doesn't exist | Re-list to get a current URI; it may have been removed         |
| No availability shown | The event type has no open slots in range | Check the event type's availability schedule in Calendly       |
| Token feature missing | API is not enabled on a free plan         | Upgrade or ask the account owner to enable API access          |

For general connection issues, see [/mcp/integrations](/mcp/integrations).

## 9. Frequently asked questions

**Is my data stored by UnleashX?**
UnleashX calls Calendly live with your token when a tool runs. It doesn't keep a separate copy of your calendar.

**Can multiple team members connect?**
Yes. Each person creates their own token (or completes OAuth) and connects it to their agent.

**How do I rotate my key?**
Generate a new Personal Access Token in Calendly's API & webhooks page, update it in UnleashX, then revoke the old one.

**Can the agent cancel meetings?**
The exposed tools focus on reading your schedule and creating links/bookings; there is no cancel tool in this integration.

## 10. References

* Calendly API documentation: [https://developer.calendly.com/](https://developer.calendly.com/)
* API & webhooks page: [https://calendly.com/integrations/api\_webhooks](https://calendly.com/integrations/api_webhooks)
* Personal Access Token guide: [https://developer.calendly.com/api-docs/ZG9jOjI3ODM2MTAz-getting-started](https://developer.calendly.com/api-docs/ZG9jOjI3ODM2MTAz-getting-started)