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

# Calendly

> Connect Calendly to xpander and give agents its 43 actions: how to sign in and connect it, and which actions to hold for approval.

<Badge color="blue">HTTP API connector</Badge>

An HTTP API described by an OpenAPI spec, not an MCP server. Calls go to `https://api.calendly.com` and carry an OAuth 2.0 token obtained with **Sign in with Calendly** on the cloud edition, or an API key or custom header on a self-hosted installation, which offers no sign-in flow.

## What the skill can do

API connector: 43 actions, as they appear in the skill panel. 13 of them create, change or delete something in Calendly; mark those under **These actions need approval** when you add the skill to an agent.

* **Group management** (5): Activity Management List Activity Log Entries, List Group Relationships, Get Group Relationship, List Groups, Get Group Details
* **Eventtype management** (5): Event Type Management List Event Type Hosts, Event Type Management List User Event Types, Event Type Management Get Event Type Details, Event Type Management Create One Off Event Type, Scheduling Management Create Single Use Scheduling Link
* **Invitation management** (4): Get Organization Invitation, Revoke Organization Invitation, List Organization Invitations, Invite User To Organization
* **Userprofile management** (4): Schedule Management List User Availability Schedules, Schedule Management Get Availability Schedule, User Management Get Current User Info, User Management Get User Details
* **Webhook management** (4): List Webhook Subscriptions, Create Webhook Subscription, Get Webhook Subscription, Delete Webhook Subscription
* **Compliance management** (3): Request Event Data Deletion, Request Invitee Data Deletion, Event Customization Create Customized Event Share
* **Noshow management** (3): No Show Management Mark Invitee As No Show, No Show Management Get Invitee No Show Details, No Show Management Undo Invitee No Show Mark
* **Organizationmembership management** (3): Membership Management List Organization Memberships, Membership Management Get User Organization Membership, Membership Management Remove User From Organization
* **Invitee management** (3): Webhook Management Get Sample Webhook Data, Get Invitee Details, Get Event Invitees List
* **Scheduledevent management** (3): Event Management List Scheduled Events, Event Management Get Scheduled Event Details, Event Management Cancel Scheduled Event
* **Availability management** (2): Get Event Type Available Times, Get User Busy Times
* **Routingformsubmission management** (2): Routing Form Management List Form Submissions, Routing Form Management List Routing Forms
* **Routingform management** (2): Routing Form Management Get Submission Details, Routing Form Management Get Routing Form Details

## Authentication Options

<Tabs>
  <Tab title="Built-in xpander Auth">
    The simplest way to connect Calendly is by using xpander's built-in authentication:

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Calendly** and select it.
    3. Click **Sign in with Calendly**.
    4. Grant xpander permission to access your account.
    5. Your Calendly integration is now ready to use.
  </Tab>

  <Tab title="API Access">
    ### Generate a Calendly API Key

    1. Log in to your [Calendly account](https://calendly.com/).

    2. Click on **Integrations & apps** in the sidebar.

    3. Click on **API and webhooks**.\\
           <img src="https://mintcdn.com/xpanderai-099931d1/5IzYOSSQmZrp4VUS/images/connectors/calendly/img_1.png?fit=max&auto=format&n=5IzYOSSQmZrp4VUS&q=85&s=cbed5b1ee7b60d0e98c13cbfe7d50c79" alt="Img 1" width="1152" height="599" data-path="images/connectors/calendly/img_1.png" />

    4. Click **Get a token now**.

    5. Enter a name for your token, then click **Create token**.

    6. Save the access token.

    ### Connect Calendly in xpander

    1. In Xpander Chat, open the agent's settings and click **Add skill**.
    2. Search for **Calendly** and select it.
    3. Click **Other auth options**.
    4. Enter a **connection name**, e.g., "xpander-calendly".
    5. Choose **Organization** access (one shared account) or **Personal** (your own account, so the agent acts with your permissions where systems allow). On an agent other people use, a personal connection runs their requests as you unless the binding requires each person's own sign-in; see [whose credential a shared agent uses](/use/agents/permissions#whose-credential-a-shared-agent-uses).
    6. Select **API Key** as the authentication method.
    7. Paste the Calendly access token into the provided field.
    8. Choose **Bearer** as the **Type**.
    9. In the **Interface specific settings** section, enter `https://api.calendly.com/` as the base URL.
    10. Click **Connect**.
  </Tab>
</Tabs>

## Give an agent the Calendly skill

Once Calendly is connected, any agent you can edit may be given the skill: open the agent's settings, click **Add skill**, and choose **Calendly**. The skill panel lists the Calendly actions by group. Enable only the groups the agent needs, and mark the actions that should wait for a named person's sign-off under **These actions need approval**. Which skills exist for your organization, and who may add them, is decided by your admins; see [Skills](/use/skills).

## Related Resources

* [Skills](/use/skills)
* [Calendly API Documentation](https://developer.calendly.com/api-docs/4b402d5ab3edd-calendly-developer)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.