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).

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
- Location ID
- 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.