Follow the procedure below to register and authenticate your public application with the Calendly API v2.
Sign up for a Calendly developer account using your Github or Google account by clicking the Sign Up button found in the top right corner of this page. Note: This is not your Calendly user account and is not associated with your Calendly user account.
Create a new OAuth application
Provide name of your application
Select the kind of application (web or native)
Select your environment that you want to associate your application
We recommend starting with Sandbox for development and creating a second application for Production when ready to go live with customer data.
For the Sandbox environment, we allow HTTP with localhost domain. Example: http://localhost:1234
For the Production environment, this must be HTTPS
For mobile or native applications use a specific redirect_uri, a Proof Key for Code Exchange (PKCE), and S256 for code_challenge_method. For more information on native and mobile authentication, see this guide.
Proceed into the next step to view/copy your Client Id, Client Secret and Webhook signing key. Be sure to copy these values as you will not be able to access the Client Secret or Webhook signing key again.
To initiate the OAuth authorization flow, redirect your user to Get Authorization Code endpoint.
To retrieve the access token, make a POST request to Get Access Token endpoint.
To test the access token, make a call to the Get current user endpoint.
To edit attributes for existing OAuth applications:
Click on the OAuth application's menu icon then select "Edit".
The following attributes can be edited:
Name of app
Kind of app
Please note you will not be able to access the Client Secret or Webhook signing key when editing an OAuth application (these values are only displayed when the OAuth application is created).
Learn what else you can accomplish with the Calendly API.
For more information about conditions that result in an access token being revoked, please see our Frequently Asked Questions.