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:
- On the GTM Clarity listing, click Install.
- Sign in to GTM Clarity. Integrations opens on HubSpot.
- Click Connect on the agent that should send its leads to HubSpot.
- HubSpot asks which HubSpot account to connect and shows the access GTM Clarity needs. Choose the account and click Connect app.
- 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,phoneandcompany. - 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 object | GTM Clarity | Why |
|---|---|---|
| Contacts | Creates and updates | Sends each identified visitor and their chat details |
| Contacts | Reads | Finds the contact to update by email, and checks the connection every 30 minutes |
| Contact properties | Reads | Lists 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:
- In HubSpot, click the settings icon, then Integrations > Connected Apps.
- 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.