Open navigation

HubSpot: Authentication and reauthentication guide

This guide will walk you through how to authenticate or reauthenticate HubSpot with Google Sheets, Data Studio, and Microsoft Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.

Before you begin

To connect Supermetrics to HubSpot, you need:

Here’s an example of sufficient user permissions:

Data refresh

A HubSpot account can contain a very large amount of data. To improve performance, Supermetrics caches this data, which means that it might take some time to complete the import when you first connect Supermetrics to HubSpot.

The initial import could take days, depending on the size of the account. Once it’s completed, HubSpot will import data once per day. This means you’ll need to wait for the next daily import to finish if you’re looking for data — on deals or contacts, for example — that’s been modified since the last import.

Custom properties

The Supermetrics HubSpot connector supports custom properties for "Contacts", "Companies", "Tickets", "Products", "Line items", and "Deals". 

If the custom properties are not appearing, use Supermetrics’ monitoring tool check that the last import completed for "Contacts", "Companies", "Tickets" "Products", "Line Items" and/or "Deals" successfully.

If the import has been completed but you still don’t see the properties in Supermetrics, refresh your account data.

Data protection agreement 

If you have any questions about how Supermetrics handles and secures your data, read our policy on data privacy and security.


Google Sheets Data Studio  Excel Data integrations
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
  1. Open a new Google Sheets file. 
  2. Click Add-ons → Supermetrics → Launch to open the sidebar.
  3. Under Data source, select HubSpot
  4. Click Start.
  5. Enter your email address and password, and click Log in
  6. Click Allow.
  7. Choose an account.
  8. Click Grant access if you have sufficient access. 

    Note: if you see the screen below ask your HubSpot subscription administrator to grant you higher permissions.

  9. Under Select accounts, select your accounts.

Learn how to reauthenticate the data source with Supermetrics Google Sheets.


  • If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide
  • If you encounter a permission error such as “user permission denied” or similar, follow this guide.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.