How to create a token-based connection in Highlevel

Updated: August 23, 2026

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).
   
2. Open Private Integrations
   Go to Settings → Private Integrations (inside the sub-account)
   
3. Create a New Integration
   Click Create Integration
   
4. Name Your Integration
   Provide a clear name for your token (e.g., Unified Integration)
   
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

6. Create and Confirm
   Click Create, then click Confirm
   
7. Copy API Token
   You will receive an API Token
   
   Store it securely (you won't be able to retrieve it later)
   
8. Get Location ID
   To find your Location ID:
   
   Look at the URL of your sub-account
   Example:
   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
   • Select API TOKEN
   • Click Activate
   
   
10. Create Connection
    Paste API Token and Location ID, then click Create Connection
    

✅ 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 team for support.