Skip to main content

HubSpot

Send the visitors your GTM Clarity agent identifies, with their chat details, to your HubSpot contacts.

Before you start​

  • A GTM Clarity account, and a GTM Clarity user who can manage integrations.
  • A HubSpot user who can install apps in your HubSpot account (a Super Admin, or a user with the App Marketplace permission).
  • Any HubSpot edition. GTM Clarity writes only contacts.

Install​

From the HubSpot App Marketplace:

  1. On the GTM Clarity listing, click Install.
  2. Sign in to GTM Clarity. Integrations opens on HubSpot.
  3. Click Connect on the agent that should send its leads to HubSpot.
  4. HubSpot asks which HubSpot account to connect and shows the access GTM Clarity needs. Choose the account and click Connect app.
  5. You are back on Integrations, which says "HubSpot connected."

From GTM Clarity: open Integrations, open HubSpot, and click Connect on the agent, then follow steps 4 and 5.

Each agent has its own connection. Connect every agent that should send leads, to the same HubSpot account or to different ones.

Configure​

The field map appears below the connection once it is connected.

  • Always sent: email, the match key.
  • Mapped by default: first name, last name, phone and company, to HubSpot's firstname, lastname, phone and company.
  • Sent once you map them: the chat lead fields (summary, transcript, duration, start URL, referrer, location, chat category and campaign attribution) and the visitor's answers to your qualifying questions. Map each one to a contact property that already exists in HubSpot; GTM Clarity never creates properties.

Property names are checked against your HubSpot account when you save. Send test sends one sample contact using the saved mapping, so save first.

What syncs​

  • Identified visitor: a contact is created or updated, matched by email, with their name, phone, company and your mapped fields.
  • Conversion or resolution: the contact is created or updated by email with your mapped fields. The name and phone your team entered in HubSpot are not overwritten.
  • Outcome marked: when a reviewer marks a chat's outcome and you have mapped the chat category, the existing contact is updated with it. A visitor never synced before is not created by a mark.

Nothing is sent for a visitor without an email address. GTM Clarity never deletes HubSpot contacts and never reads anything but contacts.

Data and access​

HubSpot objectGTM ClarityWhy
ContactsCreates and updatesSends each identified visitor and their chat details
ContactsReadsFinds the contact to update by email, and checks the connection every 30 minutes
Contact propertiesReadsLists your properties in the field map

The access HubSpot asks you to approve: crm.objects.contacts.write, crm.objects.contacts.read and crm.schemas.contacts.read.

Checking a delivery​

The connection shows Not delivering when its last send failed, with the reason. On a prospect's page under Prospects, the Destinations tab shows whether the prospect synced to HubSpot, with a Re-push button.

Disconnect​

In Integrations, open HubSpot, open the agent's connection and click Disconnect. That agent stops sending to HubSpot. Contacts already in HubSpot stay as they are.

Uninstall​

To remove GTM Clarity from HubSpot entirely:

  1. In HubSpot, click the settings icon, then Integrations > Connected Apps.
  2. Find GTM Clarity and choose Uninstall.

GTM Clarity can no longer reach HubSpot. Every agent connected to that HubSpot account shows Not delivering until it is connected again, and contacts already in HubSpot stay as they are. Disconnect those agents in Integrations too, so they stop trying.

Support​

Email support@gtmclarity.ai.