Calendly logoCalendly logo
Developer

Getting started with the Calendly API

Put your data to work so you can accomplish tasks quicker

We currently provide two 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 more in the embed options overview.

Build integrated apps for your team or customers

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 permissions

Access to the Calendly API is determined by your subscription and user role in Calendly. 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
How to authenticate with OAuth 2.0