Open navigation

Hotjar connection guide

This guide contains all permissions and requirements for connecting your Horjar data to Supermetrics.


You can connect to data sources from the Data sources page on the Supermetrics Hub. On the Hub, you can also share an authentication link to connect to a data source you don't have direct access to.


After you connect to the data source on the Hub, you can use the data source connection in all available destinations.


Required permissions

Before using the Hotjar connector, make sure that your Hotjar plan includes access to their API. See this Hotjar support article for information on how to subscribe to API access. 


To connect Supermetrics to your Hotjar account, you need to generate API credentials (client ID and client secret) as well as the site ID for the site you want to fetch data for.


Step 1: Generate API credentials
  1. Log in to the Hotjar platform
  2. Open the Organization Settings page
  3. Click API from the left menu bar.
  4. Select your organization.
  5. Enter a name for the credential, for example “Supermetrics”.
  6. For scopes, select “Survey responses”.
  7. Click Generate credentials.
  8. Copy the Client ID and Client secret to a safe place for later reference.
Step 2: Get your site ID
  1. Log in to the Hotjar platform.
  2. Open the Sites & Organizations page.
  3. The site ID is in the left-most column in the table, next to the site name.

Query types

If prompted, you need to select a query type to pull data.

  • Surveys: Behavior analytics and feedback data to help users empathize and understand their customers through surveys tool.


Connection instructions

When connecting to Hotjar, you need to provide your API credentials.

  1. Select the Hotjar data source on the Supermetrics Hub or in the data destination.
  2. Enter your client ID, client secret, and site ID.
  3. Give a name for your site so you can identify it later.
  4. If prompted, choose to make this connection shared or private.
  5. Click Start.
  6. In your data destination, select the query type, if prompted


See detailed instructions on how to connect to a data source from the Supermetrics Hub.


You can also connect to Hotjar from these destinations:


More resources

Did you find it helpful? Yes No

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