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

# Calendly Integration for Invoca AI Agents

> Connect Calendly to Invoca AI agents to book meetings from your event types on paid plans, or send one-time scheduling links on the free plan.

The Calendly integration lets your Invoca AI agents schedule meetings from your Calendly event types during a conversation. On a paid Calendly plan, the agent books the meeting directly. On the free plan, it sends the caller a one-time scheduling link instead.

It works with both voice and SMS agents.

| Capability | What the agent can do | Changes Calendly data? |
| - | - | - |
| Event types | List your event types, with their length and any questions they ask | No |
| Availability | Find open times for one event type | No |
| Book a meeting | Book the time the caller confirms (paid plans) | Yes, only after the caller confirms |
| Scheduling link | Send a one-time link so the caller picks a time (any plan) | Yes, only after the caller confirms |
| Find a meeting | Find the caller's scheduled meetings by their email | No |
| Cancel a meeting | Cancel a meeting the caller confirms | Yes, only after the caller confirms |

Setup takes three steps: confirm your event types, connect Calendly in Invoca, and attach the skill to your agent's Schedule Appointment action.

## Before you begin

* **Calendly is enabled on your Invoca account.** If you don't see it in Manage Integrations, contact Invoca.
* **Your event types are set up in Calendly.** The agent uses your existing event types and can't create or change them. Give each one a clear name, because the agent tells them apart by name and length.
* **Check your Calendly plan.** Booking directly needs a paid Calendly plan. On the free plan, the agent can only send scheduling links.
* **Connect as the right Calendly user.** The agent sees the event types of the Calendly user who connects. Use the account that owns the event types you want the agent to offer.

## Connect Calendly

You connect by signing in to Calendly from Invoca and approving access. Invoca never sees or stores your Calendly password.

1. In Invoca, open **Manage Integrations** and select **Calendly**.
2. Add a new connection.
3. Sign in to Calendly as the user who owns the event types the agent should offer.
4. Review the access Invoca is requesting, then approve it.
5. Confirm the connection shows as connected.

| Access | Why it's needed |
| - | - |
| Read your user profile | Identify the connected Calendly user |
| Read event types | List the meetings the agent can offer |
| Read scheduled events | Find a caller's existing meetings |
| Manage scheduled events | Book and cancel meetings |
| Create scheduling links | Send one-time scheduling links |

## Prepare your event types

The agent follows the rules you've set on each event type in Calendly, so set them up the way you want callers to book.

* **Names and lengths:** the agent picks an event type by its name and duration. Use names a caller would recognize, such as "30-minute consultation".
* **Availability:** open times come from the event type's own availability, buffers, and notice settings.
* **Questions:** the agent collects answers to your event type's custom questions before it books.
* **Location:** if an event type asks the invitee for a location, such as a phone number to call, the agent must collect it before booking.
* **Guests:** the agent can add up to 10 guests to a booking.

## Add the skill to your AI agent

1. Open your agent in **Agent Builder**.
2. Open the **Schedule Appointment** action.
3. In the skill field, choose the Calendly scheduling skill, then choose your Calendly connection.
4. Test the agent with a test booking, then publish it.

## How scheduling works

The agent only offers times Calendly returns, and reads back the meeting type, date, time, and the caller's details before it books, cancels, or sends a link. The caller must confirm in a later message; asking about availability isn't agreement to book.

| Caller asks to | What the agent does in Calendly |
| - | - |
| See open times | Finds open times for the chosen event type, in the caller's timezone. If none are open, it says so. |
| Book | Books the confirmed time with the caller's name, email, and answers. If the time was just taken, it offers others. If the plan doesn't allow direct booking, it sends a scheduling link instead. |
| Get a link | Sends a one-time scheduling link for one event type. Unused links expire after 90 days. A link isn't a booking until the caller picks a time. |
| Find a meeting | Looks up the caller's meetings by their email address |
| Cancel | Cancels the confirmed meeting with a reason. A meeting that's already canceled counts as done. |
| Reschedule | Books the new time, then cancels the old one. |

The agent never says a meeting is booked unless Calendly confirmed the booking.

## Data and privacy

* **Lookups by the caller's own email.** The agent finds meetings using the email address the caller gives, and only confirms details the caller already shared.
* **No made-up results.** The agent never invents a time or a meeting, and only says a meeting is booked after Calendly confirms it.
* **No internal details.** The agent doesn't say IDs or system terms to the caller.
* **Secure sign-in.** You connect through Calendly's own sign-in, and Invoca doesn't store your password. To stop access, remove the connection in Manage Integrations, or remove Invoca from your connected apps in Calendly.

## Limitations

* **Free plan: links only.** Without a paid plan, the agent can send a scheduling link but can't book directly.
* **No direct reschedule.** The agent books the new time and cancels the old one.
* **Email needed to cancel.** The agent finds a caller's meetings by email, so the caller must give the address they booked with.
* **Search window.** The agent can look for open times up to about two months ahead in one search.
* **Event types are read-only.** The agent can't create or edit event types, users, or your organization's settings.
* **Rare double bookings.** If two people book the same time at the same moment, Calendly may accept both.

## Troubleshooting

| What you see | Likely cause | What to do |
| - | - | - |
| Calendly isn't listed in Manage Integrations | It isn't turned on for your Invoca account | Contact Invoca to turn it on |
| The agent sends links instead of booking | Your Calendly plan doesn't allow direct booking | Upgrade to a paid Calendly plan, or keep using links |
| The agent offers the wrong meeting type | Event type names are unclear | Rename event types so each is easy to tell apart |
| No event types are found | A different Calendly user connected | Reconnect as the user who owns the event types |
| No times are offered | The event type has no availability in that range | Check the event type's schedule in Calendly |
| Booking fails for one event type | The event type needs a location or answer the agent didn't collect | Check the event type's location and required questions |
| The agent can't find a meeting to cancel | The caller gave a different email | Ask for the email they booked with |

Still stuck? Contact Invoca with the agent name and the time of the conversation.


## Related topics

- [Zoom Integration for Invoca AI Agents](https://docs.invoca.com/s/article/zoom-agent-integration.md)
- [Salesforce Integration for Invoca AI Agents](https://docs.invoca.com/s/article/salesforce-agent-integration.md)
- [Microsoft Outlook Integration for Invoca AI Agents](https://docs.invoca.com/s/article/microsoft-outlook-agent-integration.md)
- [Dentrix Ascend Integration for Invoca AI Agents](https://docs.invoca.com/s/article/dentrix-ascend-agent-integration.md)
- [ServiceTitan Integration for Invoca AI Agents](https://docs.invoca.com/s/article/servicetitan-agent-integration.md)
