---
title: "How to create a token-based connection in Highlevel"
img: https://unified.to/images/logo.svg
date: 2026-04-23T16:55:00.000Z
tag: Guides
description: "This guide walks you through creating a HighLevel token-based connection using a sub-account (location) API key in Unified."
url: "https://docs.unified.to/guides/how_to_create_a_token_based_connection_in_highlevel"
---

# How to create a token-based connection in Highlevel
------
_April 23, 2026_

This guide walks you through creating a **HighLevel token-based connection** using a **sub-account (location) API key** in Unified.


---


## ⚠️ Important Context


HighLevel operates on two levels:

- **Agency level (company)**
- **Sub-account level (location)** ✅ _(token-based authentication works only here)_

To access **CRM** and **HRIS** data, you must use a **sub-account (location)** API key.

> **Note:** HighLevel offers multiple ways to create connections. To avoid issues, follow every step in this guide carefully.

---


## ✅ Prerequisites

- You must have **Admin** or **Owner** access to the sub-account.

## 🔧 Step-by-Step Setup

1. Navigate to Your Sub-Account

    Go to your **HighLevel sub-account (location)**.


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-0.png)

2. Open Private Integrations

    Go to **Settings → Private Integrations** _(inside the sub-account)_


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-1.png)

3. Create a New Integration

    Click **Create Integration**


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-2.png)

4. Name Your Integration

    Provide a clear name for your token (e.g., `Unified Integration`)


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-3.png)

5. Select Required Scopes

    Choose scopes based on your use case:


    | Permission | Resource      | HighLevel Scopes                                 |
    | ---------- | ------------- | ------------------------------------------------ |
    | Read       | CRM Contact   | `contacts.readonly`                              |
    | Write      | CRM Contact   | `contacts.write`                                 |
    | Read       | CRM Company   | `businesses.readonly`, `locations/tags.readonly` |
    | Write      | CRM Company   | `businesses.write`, `locations/tags.write`       |
    | Read       | CRM Deal      | `opportunities.readonly`                         |
    | Write      | CRM Deal      | `opportunities.write`                            |
    | Read       | HRIS Employee | `users.readonly`                                 |
    | Write      | HRIS Employee | `users.write`                                    |
    | Read       | CRM Lead      | `contacts.readonly`                              |
    | Write      | CRM Lead      | `contacts.write`                                 |
    | Read       | CRM Pipeline  | `opportunities.readonly`                         |
    | Read       | CRM Event     | `forms.readonly`, `contacts.readonly`            |
    | Write      | CRM Event     | `contacts.write`                                 |
    **Reference:** [https://marketplace.gohighlevel.com/docs/Authorization/Scopes](https://marketplace.gohighlevel.com/docs/Authorization/Scopes)

6. Create and Confirm

    Click **Create, t**hen click **Confirm**


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-4.png)

7. Copy API Token

    You will receive an **API Token**


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-5.png)


    Store it securely (you won't be able to retrieve it later)


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-6.png)

8. Get Location ID

    To find your **Location ID**:


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-7.png)


    Look at the URL of your sub-account


    Example:


    ```plain text
    https://app.gohighlevel.com/v2/location/tG38xt5twyoGISw4o92p/settings/private-integrations/...
    ```


    The value after `/location/` is your **Location ID**
    → `tG38xt5twyoGISw4o92p`

9. Connect in Unified
    - Go to: [https://app.unified.to/integrations/highlevel](https://app.unified.to/integrations/highlevel)
    - Select **API TOKEN**
    - Click **Activate**

    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-8.png)

10. Create Connection

    Paste **API Token and Location ID, then c**lick **Create Connection**


    ![image.png](https://s3.us-east-2.amazonaws.com/unified-article-images/how_to_create_a_token_based_connection_in_highlevel-9.png)


---


## ✅ Done


Your HighLevel token-based connection should now be successfully set up in Unified.


---


If it doesn't work, double-check:

- You created the token at the **sub-account level**
- The correct **scopes** are selected
- The **Location ID** matches the sub-account

If you have any more doubts or issues, please contact the [Unified.to](https://unified.to/) team for support.