​
Prerequisites

  • Calendly account (personal or business)
  • Access to Calendly Developer Portal

​
Step 1: Create Calendly Developer Account

  1. Visit https://developer.calendly.com/
  2. Click “Sign In” or “Log In” if you already have an account
  3. Sign in with your Calendly account or create a new developer account
Calendly Developer Login

​
Step 2: Create a New App

  1. Once logged in, go to “Accounts” -> “My Apps”
  2. Click “Create a new app”
  3. Choose “Web App” as the integration type
  4. Fill in the app details:
    • Name of app: Your application name (e.g., your brand name)
    • Kind of app: Web/Native (depending on your need)
    • Environment Type: Sandbox/Production (Production recommended)
    • Redirect URIs: Add your callback URL:
      • https://api.klavis.ai/oauth/calendly/callback
Calendly App Creation Form
Normally, the redirect URI should be set to: https://api.klavis.ai/oauth/calendly/callback

​
Step 3: Get Your Credentials

After creating the app, you’ll see:
  • Client ID: Copy this value
  • Client Secret: Generate and copy this value (keep it secure!)
Get the Credentials
Calendly does not use traditional OAuth scopes. Once authenticated, your application has access to all API endpoints permitted by the user’s subscription and role.

​
(Optional) Step 4: White Labeling

White labeling allows you to customize the OAuth experience with your own branding instead of Klavis AI’s.
If you want to use your own Calendly OAuth application with custom branding:
  1. Configure White Labeling: Go to https://www.klavis.ai/home/white-label
  2. Add Your Credentials: Enter your Calendly Client ID and Client Secret from Step 3
  3. Set Redirect URI: Use https://api.klavis.ai/oauth/calendly/callback or your custom callback URL
  4. Initiate OAuth: Use your client ID when starting the OAuth flow: 
    const authUrl = `https://api.klavis.ai/oauth/calendly/authorize?instance_id=${instanceId}&client_id=${yourClientId}`;
For detailed white labeling implementation and code examples, see our OAuth & White Labeling guide.

​
Resources