Calendly Logo
Calendly Developer

Getting Started

Overview

The Calendly API is a REST-based API. Our API has predictable resource-oriented URLs, uses JSON for request and response bodies, and standard HTTP response codes, authentication, and verbs.

Before you begin

Here are a couple of things to know before you start.

  • Calendly API v2 supports authentication via OAuth 2.0

  • To subscribe to webhooks, you need to have a paid Premium or Pro Calendly account. All other API access mirrors the access level you have in the Calendly web app.

If you would like to add Calendly scheduling to your website, you do not need OAuth credentials. Learn about your options for embedding Calendly in this article.

If you have any questions, contact support+developer@calendly.com.

Authorization

To register your application:

  1. Go to https://calendly.com/login and log in to your Calendly account.

  2. Register as a Calendly developer by completing this form. We’ll process your request within 1 day and email you when it’s time to complete the setup.

  3. Calendly will email you and ask for:

    • The name of your app

    • Your OAuth redirect URI (must be HTTPS for web applications)

    You will be granted a Client ID and Client Secret for your application to authorize with Calendly API via OAuth.

  4. You’ll receive your Client ID and Client Secret via the password manager LastPass.

  5. See our OAuth documentation for a detailed authentication and authorization walkthrough.