Skip to main content

Connect HighLevel

This article covers how to connect HighLevel to a Client, manage its settings, and troubleshoot common data issues in AgencyAnalytics.

Written by AgencyAnalytics Team

HighLevel is a sales and marketing platform that helps agencies manage customer relationships.

With tools for automating lead generation, nurturing, and follow-ups, it simplifies tasks such as managing pipelines, sending email or SMS campaigns, and even scheduling appointments.

API and Data Access

  • HighLevel API 2.0

  • 365 days of historical data

  • Sub-account support

Click here to view all available HighLevel metrics and learn what's possible with the HighLevel integration!


Before You Start

To avoid a failed connection or error when integrating HighLevel with a Client, the person connecting must have:

  • Logged into the HighLevel account you want to connect

  • V2 API access


Connect HighLevel

Once the requirements above are met, follow these steps to connect HighLevel to a Client:

Step 1: Open the Client where you'd like to connect HighLevel, then click the Data Sources tab at the top.

Step 2: Click the blue Connect Data Source button in the upper right corner of the page.

Step 3: Search for HighLevel in the search bar at the top, then click the HighLevel card.

Step 4: Click the gray Plus (+) sign at the bottom to open the authorization window.

Step 5: Follow the prompts in the OAuth window to verify and finalize the connection.

Step 6: On the following page, click the circle to the left of the account or sub-account for which you want to see data in this Client.

Step 7: Click Connect to finalize the connection.


Manage HighLevel Settings

To make sure your reporting is accurate, review your HighLevel settings after connecting.

Step 1: Navigate to a Client with HighLevel connected, and select HighLevel under Default Dashboards.

Step 2: Within the HighLevel integration dashboard, select the settings icon, then within the Settings tab, select Manage.

Step 3: On the account page, click the Ellipsis to the right of the HighLevel account you want to update.

Step 4: Click Edit Settings in the dropdown.

In the HighLevel settings, click either menu to open a dropdown with additional values to choose from.

Currency should be set to match the currency of the account you've connected.

The second setting, Opportunity and Conversation Visibility, determines the type of filtering applied to the currently connected user account:

View All (Default setting)

Allows all opportunities and conversations to be viewed regardless of which user account is connected.

View Current User Only

Limits opportunities and conversations to only those assigned to the currently connected user account.

View Current User and Unassigned

Limits opportunities and conversations to only the current user and those not specifically assigned

View Unassigned Only

Displays opportunities and conversations that are not assigned to any specific user account

Once you've updated these settings, click Save in the bottom left to lock in the HighLevel settings for that Client.


FAQ

Why do I need to connect a sub-account instead of my agency account?

HighLevel updated its API, and it no longer supports agency-level connections to retrieve location-specific data. The location ID needed to pull your data is only available at the sub-account level, so a sub-account connection is required. The HighLevel user connecting the integration needs to be invited to, or already have permissions on, the sub-account being connected.

Why is my data missing or incomplete?

A few things can cause this:

  • Accounts with very high record volumes (hundreds of thousands of records per year) may experience request timeouts. If you're seeing this, try narrowing your report to a shorter date range

  • Opportunities are sorted by their creation date. It isn't currently possible to sort by close date or last updated date

  • HighLevel enforces its own API rate limits. Each request can pull a maximum of 100 items, so as a rough guide, expect about one request per 100 leads, contacts, or conversations

How should I compare my AgencyAnalytics data to HighLevel's dashboard?

Use the Created On date field in HighLevel when comparing records. This is the date value AgencyAnalytics uses to pull data. We also recommend excluding the current day from your comparison, since API delays or caching can cause the most recent day's numbers to look incomplete.

How do tag filters work?

HighLevel tag filters work exclusively with each other. If you filter by a single tag (for example, "Marketing Contacts"), only results with that tag will be displayed. Results with other tags won't be included, even if they'd otherwise match your other filters.

Why are some tags missing?

Tags aren't available to AgencyAnalytics directly via the HighLevel API. Our list of tags is built manually by pulling in all tagged contacts and filtering out unique tags, so we only include tags that are actually being used. Any tags that are missing are likely unused, which means those tags would return zero results if used as filters, or would have zero contacts assigned to them.


💬 Need additional help?

If you have any questions, please contact our friendly support team by following these instructions! We're available 24/5 to help 😄

Did this answer your question?