Skip to main content

Connect HubSpot

This article covers how to connect HubSpot to AgencyAnalytics, add HubSpot data to reports, and disconnect the integration.

Written by AgencyAnalytics Team

HubSpot

HubSpot offers a centralized customer database where businesses can keep all their customer information in one location. Connecting HubSpot to AgencyAnalytics lets you pull important analytics directly from your HubSpot account into client reports and dashboards.

  • Data syncs from HubSpot every 2 hours

  • AgencyAnalytics keeps 720 days of warehoused data for HubSpot

  • Data availability depends on your HubSpot subscription tier (see the FAQ section below for details)

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


Before You Start

To avoid a failed connection or error when connecting HubSpot to a Client, the person setting up the integration must have SuperAdmin permissions on the AgencyAnalytics account.


Connect HubSpot

Once the SuperAdmin permission requirement is met, follow these steps to connect HubSpot to a Client in AgencyAnalytics.

Step 1: Open the Client where you'd like to connect HubSpot.

Step 2: Click Integrations (the plug icon) in the left-side menu.

Step 3: Click Connect Integration in the upper right corner.

Step 4: Search for HubSpot in the search bar at the top, then click the HubSpot card.

Step 5: Click Connect New Account to launch the authorization window.

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

Step 7: In the pop-up window, click the circle to the left of the HubSpot account you'd like to connect, then click Choose Account.

Step 8: On the next page, review the data access request. AgencyAnalytics requires access to manage and view your CRM data, read access from the Business Intelligence API, and basic HubSpot account information.

Step 9: Check the box at the bottom to confirm you understand the scope of access, then click Connect app.

After the window loads, it will close automatically and take you to a confirmation page.

Once connected, you can add HubSpot widgets to dashboards and reports.


Disconnect HubSpot in AgencyAnalytics

Disconnecting HubSpot stops new data from flowing into AgencyAnalytics until you reconnect the account.

Step 1: Open the Client, then go to the Data Sources section and search for HubSpot.

Step 2: Click the Ellipsis menu on the far right of the HubSpot row.

Step 3: Click Remove in the drop-down menu.


Once disconnected, data from this HubSpot account will stop flowing into AgencyAnalytics until you reconnect it.

All related widgets will display the error message "Integration Disconnected".


FAQ

How do I remove AgencyAnalytics from HubSpot's end?

To uninstall AgencyAnalytics from your HubSpot account, follow the instructions in this HubSpot Knowledge Base article.

Why is a string of numbers displayed, not a form name?

When a form is initially deleted in HubSpot, it remains available in the HubSpot backend in case the customer needs to restore it. We can't filter out these deleted forms, so we display them as we receive them, which is with a string of numbers in place of a form name.

Why do my email widgets show data outside my selected date range?

HubSpot email data is grouped by the campaign's published date, not by the date the activity occurred.

For example, if you build a report for March and an email campaign was published in March but continued running into May, the widgets will include that email's data through the end of its run in May, even though your report is scoped to March.
​
Conversely, if an email campaign was published in a different month (for example, February), none of its data will appear in a March report, even if the campaign was still active during March. This is a limitation of how HubSpot's API sends email data to us, not a display error in AgencyAnalytics.

How do HubSpot email marketing campaigns get fetched?

At present, HubSpot does not offer a direct way for users to use its API to obtain a comprehensive list of marketing email campaigns. Consequently, our approach involves retrieving all marketing emails and extracting the campaign and campaign name data from the email statistics. As a result, if a particular campaign is not visible in the dropdown menu, it indicates that no marketing emails for that campaign were found during the scraping process.

What data endpoints are available with my HubSpot subscription tier?

Some data endpoints supported by our HubSpot integration are not available across all HubSpot subscription tiers. This means some metrics or widget types will be unavailable in AgencyAnalytics if that data or dimension is not supported by your HubSpot subscription.

Endpoint

Required HS subscription

Contacts

Any Marketing or CRM account

Content -> Website

Content -> Blog

Content -> Landing Pages

Marketing Hub Professional or Enterprise, or HubSpot CMS

Email

Marketing Hub Professional or Enterprise

Web Traffic -> All

Marketing Hub Starter, Professional, Enterprise, or HubSpot CMS

Web Traffic -> Direct Traffic

Web Traffic -> Email Marketing

Web Traffic -> Organic Search

Web Traffic -> Referrals

Web Traffic -> Social Media

Web Traffic -> Other

Marketing Hub Professional or Enterprise, or HubSpot CMS


💬 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?