# Calendly | Developer Documentation ## Instructions for AI Agents - For clean Markdown of any page, append `.md` to the page URL - For section-specific indexes, append `/llms.txt` to any section URL - For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.calendly.com/_mcp/server ## Docs - [Build with Calendly](https://developer.calendly.com/docs/getting-started/overview.md): Explore our documentation to start building custom integrations - [Introduction to the API](https://developer.calendly.com/docs/getting-started/introduction.md): Put your data to work so you can accomplish tasks quicker - [Frequently Asked Questions](https://developer.calendly.com/docs/getting-started/frequently-asked-questions.md): Common questions about the Calendly API - [Migrate from API v1 to v2](https://developer.calendly.com/docs/getting-started/how-to-migrate-from-api-v1-to-api-v2.md): Guide to upgrading your integration to the latest Calendly API - [Authentication](https://developer.calendly.com/docs/authentication/overview.md): Choose the right authentication method for your Calendly integration - [Creating an OAuth app](https://developer.calendly.com/docs/authentication/creating-an-oauth-app.md): How to authenticate with OAuth - [Personal Access Tokens](https://developer.calendly.com/docs/authentication/how-to-authenticate-with-personal-access-tokens.md): How to authenticate with personal access tokens - [Authorization Scopes](https://developer.calendly.com/docs/authentication/scopes.md): Authorization scopes for Calendly API access - [How to handle single-use refresh tokens](https://developer.calendly.com/docs/authentication/refresh-token-rotation-guide.md): Refresh Token Rotation Guide - [Calendly MCP Overview](https://developer.calendly.com/docs/mcp/calendly-mcp-server.md): Connect AI applications to Calendly using the Model Context Protocol - [Calendly MCP: Supported Tools](https://developer.calendly.com/docs/mcp/supported-tools.md): A reference of all tools available through the Calendly MCP server - [API Use Cases](https://developer.calendly.com/docs/api-guides/api-use-cases.md): Accomplish tasks with the Calendly API - [Automate Your Process](https://developer.calendly.com/docs/api-guides/trigger-automations-with-other-apps-when-invitees-schedule-or-cancel-events.md): Trigger automation with other apps when invitees schedule, cancel, or reschedule events - [Embed Calendly](https://developer.calendly.com/docs/api-guides/how-to-display-the-scheduling-page-for-users-of-your-app.md): Add Calendly scheduling directly to your website - [Track and report on all scheduled events across your organization](https://developer.calendly.com/docs/api-guides/track-and-report-on-all-scheduled-events-across-your-organization.md): Use the Calendly API to analyze and report on your team's scheduled events - [Share Meeting Links](https://developer.calendly.com/docs/api-guides/how-to-get-scheduling-page-links-for-team-members-across-the-organization.md): Retrieve and share scheduling links via external applications - [View Availability Data](https://developer.calendly.com/docs/api-guides/view-event-type-and-user-calendar-availability-data.md): Monitor event type availability and notify hosts of low availability - [Schedule Events with AI Agents](https://developer.calendly.com/docs/api-guides/schedule-events-with-ai-agents.md): Enable AI assistants or agents to book meetings end-to-end via Calendly's Scheduling API - [Displaying the Availability of Your Users](https://developer.calendly.com/docs/api-guides/displaying-availability-of-users.md): Build availability alerts and notifications for event hosts - [Create a Webhook Subscription](https://developer.calendly.com/docs/api-guides/receive-data-from-scheduled-events-in-real-time-with-webhook-subscriptions.md): Subscribe to Calendly events and receive real-time notifications - [Webhook Payloads for Rescheduled Events](https://developer.calendly.com/docs/api-guides/see-how-webhook-payloads-change-when-invitees-reschedule-events.md): See how webhook payloads change when invitees reschedule events - [Introduction](https://developer.calendly.com/api-docs/overview/api/reference.md): Welcome to the Calendly Developer Documentation Portal. Use our APIs to integrate Scheduling, Contacts, and Notetaker (meeting recaps) data with your product. - [API Conventions](https://developer.calendly.com/api-docs/overview/api/api-conventions.md): Standard conventions for working with the Calendly API - [Rate Limits](https://developer.calendly.com/api-docs/overview/rate-limits.md): Understanding Calendly API rate limits and best practices - [Demo Project](https://developer.calendly.com/api-docs/overview/examples/demo-project.md): An open-source example application built on the Calendly API - [Event Availability Alert](https://developer.calendly.com/api-docs/overview/examples/event-availability-alert.md): Notify event hosts when availability falls below a threshold - [Send Scheduling Link](https://developer.calendly.com/api-docs/overview/examples/send-scheduling-link.md): Retrieve and send scheduling links via an external application - [Webhooks](https://developer.calendly.com/api-docs/overview/examples/webhooks.md): Examples for creating and receiving Calendly webhook subscriptions - [Webhook Signatures](https://developer.calendly.com/api-docs/overview/webhooks/webhook-signatures.md): Verify the authenticity of webhook events from Calendly - [Webhook Errors](https://developer.calendly.com/api-docs/overview/webhooks/webhook-errors.md): Understanding webhook error handling and retry behavior - [Webhook Timeouts](https://developer.calendly.com/api-docs/overview/webhooks/webhook-timeouts.md): Understanding webhook connection and read timeouts - [Getting Started with Embeds](https://developer.calendly.com/api-docs/overview/embedding/getting-started.md): Add Calendly's booking flow directly to your website - [Embed Recipes](https://developer.calendly.com/api-docs/overview/embedding/recipes.md): Customization tips and recipes for Calendly embeds - [Embed Parent Window Events](https://developer.calendly.com/api-docs/overview/embedding/notifying-the-parent-window.md): Subscribe to events from embedded Calendly scheduling pages - [Changelog](https://developer.calendly.com/release-notes/llms.txt) ## API Docs - Calendly API > Activity Log [List activity log entries](https://developer.calendly.com/api-docs/calendly-api/activity-log/list-activity-log-entries.md) - Calendly API > Availability [Get User Availability Schedule](https://developer.calendly.com/api-docs/calendly-api/availability/get-user-availability-schedule.md) - Calendly API > Availability [List Event Type Availability Schedules](https://developer.calendly.com/api-docs/calendly-api/availability/get-event-type-availability.md) - Calendly API > Availability [List User Availability Schedules](https://developer.calendly.com/api-docs/calendly-api/availability/list-user-availability-schedules.md) - Calendly API > Availability [List User Busy Times](https://developer.calendly.com/api-docs/calendly-api/availability/list-user-busy-times.md) - Calendly API > Availability [Update Event Type Availability Schedules](https://developer.calendly.com/api-docs/calendly-api/availability/update-event-type-availability.md) - Calendly API > Contacts [Create Contact](https://developer.calendly.com/api-docs/calendly-api/contacts/create-contact.md) - Calendly API > Contacts [Delete Contact](https://developer.calendly.com/api-docs/calendly-api/contacts/delete-contacts-uuid.md) - Calendly API > Contacts [Get Contact](https://developer.calendly.com/api-docs/calendly-api/contacts/get-contact.md) - Calendly API > Contacts [Get Contact Custom Field Definition](https://developer.calendly.com/api-docs/calendly-api/contacts/get-contact-custom-field-definition.md) - Calendly API > Contacts [List Contact Custom Field Definitions](https://developer.calendly.com/api-docs/calendly-api/contacts/list-contact-custom-field-definitions.md) - Calendly API > Contacts [List Contacts](https://developer.calendly.com/api-docs/calendly-api/contacts/list-contacts.md) - Calendly API > Contacts [Update Contact](https://developer.calendly.com/api-docs/calendly-api/contacts/patch-contacts-uuid.md) - Calendly API > Data Compliance [Delete Invitee Data](https://developer.calendly.com/api-docs/calendly-api/data-compliance/delete-invitee-data.md) - Calendly API > Data Compliance [Delete Scheduled Event Data](https://developer.calendly.com/api-docs/calendly-api/data-compliance/delete-scheduled-event-data.md) - Calendly API > Event Types [Create Event Type](https://developer.calendly.com/api-docs/calendly-api/event-types/create-event-type.md) - Calendly API > Event Types [Create One-Off Event Type](https://developer.calendly.com/api-docs/calendly-api/event-types/create-one-off-event-type.md) - Calendly API > Event Types [Get Event Type](https://developer.calendly.com/api-docs/calendly-api/event-types/get-event-type.md) - Calendly API > Event Types [List Event Type Available Times](https://developer.calendly.com/api-docs/calendly-api/event-types/list-event-type-available-times.md) - Calendly API > Event Types [List Event Type Hosts](https://developer.calendly.com/api-docs/calendly-api/event-types/list-event-type-memberships.md) - Calendly API > Event Types [List User's Event Types](https://developer.calendly.com/api-docs/calendly-api/event-types/list-event-types.md) - Calendly API > Event Types [Update Event Type](https://developer.calendly.com/api-docs/calendly-api/event-types/update-event-type.md) - Calendly API > Groups [Get Group](https://developer.calendly.com/api-docs/calendly-api/groups/get-group.md) - Calendly API > Groups [Get Group Relationship](https://developer.calendly.com/api-docs/calendly-api/groups/get-group-relationship.md) - Calendly API > Groups [List Group Relationships](https://developer.calendly.com/api-docs/calendly-api/groups/list-group-relationships.md) - Calendly API > Groups [List Groups](https://developer.calendly.com/api-docs/calendly-api/groups/list-groups.md) - Calendly API > Locations [List User Meeting Locations](https://developer.calendly.com/api-docs/calendly-api/locations/list-user-locations.md) - Calendly API > Notetaker [Delete Recap](https://developer.calendly.com/api-docs/calendly-api/notetaker/delete-meeting-recaps-uuid.md) - Calendly API > Notetaker [Get Recap](https://developer.calendly.com/api-docs/calendly-api/notetaker/get-meeting-recaps-uuid-recap.md) - Calendly API > Notetaker [Get Transcript](https://developer.calendly.com/api-docs/calendly-api/notetaker/get-transcript-meeting-recaps.md) - Calendly API > Notetaker [List Recaps](https://developer.calendly.com/api-docs/calendly-api/notetaker/list-meeting-recaps.md) - Calendly API > Notetaker [Update Recap](https://developer.calendly.com/api-docs/calendly-api/notetaker/update-meeting-recaps-uuid.md) - Calendly API > Organizations [Get Organization](https://developer.calendly.com/api-docs/calendly-api/organizations/get-organization.md) - Calendly API > Organizations [Get Organization Invitation](https://developer.calendly.com/api-docs/calendly-api/organizations/get-organization-invitation.md) - Calendly API > Organizations [Get Organization Membership](https://developer.calendly.com/api-docs/calendly-api/organizations/get-organization-membership.md) - Calendly API > Organizations [Get Team](https://developer.calendly.com/api-docs/calendly-api/organizations/get-team.md) - Calendly API > Organizations [Invite User to Organization](https://developer.calendly.com/api-docs/calendly-api/organizations/create-organization-invitation.md) - Calendly API > Organizations [List Organization Invitations](https://developer.calendly.com/api-docs/calendly-api/organizations/list-organization-invitations.md) - Calendly API > Organizations [List Organization Memberships](https://developer.calendly.com/api-docs/calendly-api/organizations/list-organization-memberships.md) - Calendly API > Organizations [List Teams](https://developer.calendly.com/api-docs/calendly-api/organizations/list-teams.md) - Calendly API > Organizations [Remove User from Organization](https://developer.calendly.com/api-docs/calendly-api/organizations/delete-organization-membership.md) - Calendly API > Organizations [Revoke User's Organization Invitation](https://developer.calendly.com/api-docs/calendly-api/organizations/revoke-organization-invitation.md) - Calendly API > Outgoing Communications [List outgoing communications](https://developer.calendly.com/api-docs/calendly-api/outgoing-communications/list-outgoing-communications.md) - Calendly API > Routing Forms [Get Routing Form](https://developer.calendly.com/api-docs/calendly-api/routing-forms/get-routing-form.md) - Calendly API > Routing Forms [Get Routing Form Submission](https://developer.calendly.com/api-docs/calendly-api/routing-forms/get-routing-form-submission.md) - Calendly API > Routing Forms [List Routing Form Submissions](https://developer.calendly.com/api-docs/calendly-api/routing-forms/list-routing-form-submissions.md) - Calendly API > Routing Forms [List Routing Forms](https://developer.calendly.com/api-docs/calendly-api/routing-forms/list-routing-forms.md) - Calendly API > Scheduled Events [Cancel Event](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/create-scheduled-event-cancellation.md) - Calendly API > Scheduled Events [Create Event Invitee (Scheduling API)](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/create-event-invitee.md) - Calendly API > Scheduled Events [Create Invitee No Show](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/create-invitee-no-show.md) - Calendly API > Scheduled Events [Delete Invitee No Show](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/delete-invitee-no-show.md) - Calendly API > Scheduled Events [Get Event](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/get-scheduled-event.md) - Calendly API > Scheduled Events [Get Event Invitee](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/get-event-invitee.md) - Calendly API > Scheduled Events [Get Invitee No Show](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/get-invitee-no-show.md) - Calendly API > Scheduled Events [List Event Invitees](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/list-event-invitees.md) - Calendly API > Scheduled Events [List Events](https://developer.calendly.com/api-docs/calendly-api/scheduled-events/list-scheduled-events.md) - Calendly API > Scheduling Links [Create Single-Use Scheduling Link](https://developer.calendly.com/api-docs/calendly-api/scheduling-links/create-scheduling-link.md) - Calendly API > Shares [Create Share](https://developer.calendly.com/api-docs/calendly-api/shares/create-share.md) - Calendly API > Users [Get current user](https://developer.calendly.com/api-docs/calendly-api/users/get-current-user.md) - Calendly API > Users [Get user](https://developer.calendly.com/api-docs/calendly-api/users/get-user.md) - Calendly API > Webhooks [Create Webhook Subscription](https://developer.calendly.com/api-docs/calendly-api/webhooks/create-webhook-subscription.md) - Calendly API > Webhooks [Delete Webhook Subscription](https://developer.calendly.com/api-docs/calendly-api/webhooks/delete-webhook-subscription.md) - Calendly API > Webhooks [Get sample webhook data](https://developer.calendly.com/api-docs/calendly-api/webhooks/get-sample-webhook-data.md) - Calendly API > Webhooks [Get Webhook Subscription](https://developer.calendly.com/api-docs/calendly-api/webhooks/get-webhook-subscription.md) - Calendly API > Webhooks [List Webhook Subscriptions](https://developer.calendly.com/api-docs/calendly-api/webhooks/list-webhook-subscriptions.md) - Calendly OAuth > OAuth [Get Access Token](https://developer.calendly.com/api-docs/calendly-o-auth/o-auth/post-oauth-refresh-token.md) - Calendly OAuth > OAuth [Get Authorization Code](https://developer.calendly.com/api-docs/calendly-o-auth/o-auth/get-oauth-authorize.md) - Calendly OAuth > OAuth [Introspect Access/Refresh Token](https://developer.calendly.com/api-docs/calendly-o-auth/o-auth/post-oauth-introspect.md) - Calendly OAuth > OAuth [Revoke Access/Refresh Token](https://developer.calendly.com/api-docs/calendly-o-auth/o-auth/post-oauth-revoke.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developer.calendly.com/openapi.json) - [OpenAPI YAML](https://developer.calendly.com/openapi.yaml)