Unified.to
All articles

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

2. Open Private Integrations

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

image.png

3. Create a New Integration

  • Click Create Integration

image.png

4. Name Your Integration

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

image.png

5. Select Required Scopes

Choose scopes based on your use case:

PermissionResourceHighLevel Scopes
ReadCRM Contactcontacts.readonly
WriteCRM Contactcontacts.write
ReadCRM Companybusinesses.readonly, locations/tags.readonly
WriteCRM Companybusinesses.write, locations/tags.write
ReadCRM Dealopportunities.readonly
WriteCRM Dealopportunities.write
ReadHRIS Employeeusers.readonly
WriteHRIS Employeeusers.write
ReadCRM Leadcontacts.readonly
WriteCRM Leadcontacts.write
ReadCRM Pipelineopportunities.readonly
ReadCRM Eventforms.readonly, contacts.readonly
WriteCRM Eventcontacts.write
Reference: https://marketplace.gohighlevel.com/docs/Authorization/Scopes

6. Create and Confirm

  • Click Create
  • Then click Confirm

image.png

7. Copy API Token

  • You will receive an API Token

image.png

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

image.png

8. Get Location ID

To find your Location ID:

image.png

  • 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 IDtG38xt5twyoGISw4o92p

9. Connect in Unified


image.png

10. Create Connection

  • Paste:
    • API Token
    • Location ID
  • Click Create Connection

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

All articles