Skip to main content

Documentation Index

Fetch the complete documentation index at: https://calendly-preview.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Build scheduling into every workflow

The Calendly API lets your product create bookings, surface availability, embed scheduling, and react to meeting events in real time.

Get StartedExplore the API

Quick Start

Go from zero to your first Calendly API call in a few minutes.

1

Create a developer account

Sign in at calendly.com and open the integrations dashboard to access API credentials.
2

Choose your authentication method

Use a personal access token for internal tools, or register an OAuth app for integrations used by other Calendly users. Request only the scopes you need.
3

Make your first request

Call the GET /users/me endpoint to confirm your token and fetch the authenticated user:
cURL
curl https://api.calendly.com/users/me \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json"

{
  "resource": {
    "uri": "https://api.calendly.com/users/ABCDEFGHIJKLMNOP",
    "name": "Pat Lee",
    "slug": "pat-lee",
    "email": "pat@example.com",
    "scheduling_url": "https://calendly.com/pat-lee",
    "timezone": "America/New_York",
    "current_organization": "https://api.calendly.com/organizations/ORG123",
    "resource_type": "User"
  }
}
4

React to scheduling in real time

Subscribe to webhooks to receive invitee.created, invitee.canceled, and routing_form_submission.created events as soon as they happen.

Build By Use Case

Start from the experience you want to ship, then follow the closest end-to-end guide.

Build embedded scheduling experiences

Launch inline or popup schedulers, surface the right booking URL, and tailor flows to live availability without sending users outside your product.

Read guide

Automate scheduling workflows

Use webhook events and meeting data to trigger downstream systems, keep records in sync, and measure what happened.

Read guide

Power AI and custom booking flows

Give assistants and internal tools secure access to availability and booking actions with the Calendly MCP server.

Read guide

Core Concepts

The building blocks every integration needs to know.

Authentication

Choose between OAuth 2.1 with PKCE for public apps or personal access tokens for internal tools.

API reference

Interactive reference for every Calendly API v2 endpoint, parameter, and response schema.

Calendly MCP server

Give AI assistants a secure, standardized way to create and manage Calendly events.

Webhook recipes

Step-by-step recipes for availability, webhook subscriptions, and reschedule payloads.

Resources & Support

Stay current on platform changes and get unblocked when you need help.

Release notes

Track API changes, new endpoints, rate-limit updates, and deprecations.

Developer community

Ask questions, share builds, and connect with other Calendly developers.

Get help

Reach Calendly’s support team or open a ticket for account-specific issues.

Platform status

Monitor live system status, incidents, and scheduled maintenance.

Ready To Start Building?

Grab an access token, follow the getting started guide, and ship your first Calendly integration in an afternoon.

Get startedOpen developer console