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.
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.
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.