Documentation

Getting started with the Calendly API

Put your data to work so you can accomplish tasks quicker

We currently provide three APIs for you to integrate Calendly into your application:

API v2: Our current, actively maintained API. The Calendly API v2 is REST-based and has predictable resource-oriented URLs. It uses JSON for request and response bodies and standard HTTP methods, authentication, and response codes.

Embed API: Our simpler, easy-to-use API that lets you add a Calendly landing or booking page to your website. See how to add Calendly to your website.

Webhook API: Our friendly, lightweight API that lets you automatically receive Calendly data with webhook subscriptions anytime invitees schedule, cancel, or reschedule a meeting.Build integrated apps for your team or customers

Authenticating requests

The Calendly API v2 uses personal access tokens and OAuth 2.0 to authenticate requests. Choose either depending on who's using the application you're integrating with Calendly.

  • If you're integrating an internal application that only your team will use, authenticate with personal access tokens.

  • If you're integrating a public application that many Calendly users will use, authenticate with OAuth.

To see specific examples of when you might choose either authentication method, see when to choose between personal access tokens and OAuth 2.0.

Review your API and webhook permissions

Access to the Calendly API is determined by your subscription and user role in Calendly, while access to webhooks is reserved for members on paid premium subscriptions and above. If your user role is not sufficient, some HTTP methods, including those that access organization-wide Calendly data, may not be available to you or others because of insufficient user privileges. To find out who in your Calendly organization has owner or admin permissions, visit your People/Admin Management page.

What's next

How to authenticate with personal access tokens
Create a Calendly Developer account


Copyright Calendly 2024We take the work out of connecting with others so you can accomplish more.Legal