# Calendly

## Calendly – Connector Configuration

### Step 1: Create a Developer Account & First Application

* Create a Calendly Developer account: [Create a Developer Account](https://developer.calendly.com/create-a-developer-account)
* Go to [Calendly Console Apps](https://developer.calendly.com/console/apps) and sign up.

> ⚠️ **Note**: This is **not** your Calendly user account. It’s a separate developer account.

***

### Step 2: Register Your OAuth Application

1. **Create a new OAuth application**:
   * Provide a **name** for your application.
   * Select the **kind of application**:
     * Web
   * Select your **environment**:
     * Sandbox (recommended for development)
     * Production (use when going live with customer data)

***

### Step 3: Set Redirect URI

* **Sandbox**: HTTP with `localhost` domain allowed\
  Example:

  ```http
  http://localhost:1234
  ```
* **Production**: Must use HTTPS.

👉 You can add multiple redirect URIs, separated by commas.\
👉 For Appmixer, set the redirect URI to:

```http
https://[YOUR_API_BASE]/auth/docusign/callback
```

Example:

```http
https://api.appmixer.com/auth/docusign/callback
```

![alt text](https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-54fd09de2780f36b360c837dd1171031ff18e06f%2FcalendlyImage-1.png?alt=media)

***

### Step 4: Copy Your Credentials

Once the app is created, you’ll see:

* **Client ID**
* **Client Secret**

⚠️ **Important**: These values will only be shown once. Copy them immediately!

***

### Step 5: Connector Configuration

1. Go to the Appmixer BackOffice -> Configuration.
2. Add new configuration: `acme:calendly` .
3. Add your `clientId` and `clientSecret` keys with values.

![alt text](https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-8639225a4d06482d73175ce1690db20e802f4311%2FcalendlyImage.png?alt=media)

![alt text](https://802996127-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIAGKHlIqVKJe9agnFr14%2Fuploads%2Fgit-blob-210dd617862824286645a9c4a3d6277d248f8e88%2FcalendlyImage-2.png?alt=media)

### Step 6: Edit Your Application

* To edit an existing OAuth app in Calendly:
  * Click the menu icon → **Edit**.
* Editable attributes:
  * Application Name
  * Kind of App
  * Environment Type
  * Redirect URI

⚠️ **Note**: Client Secret and Webhook Signing Key **cannot be retrieved again** after creation.

***