This guide explains how to connect Hunter to your HubSpot account and sync your leads. You’ll learn how to set up the integration, control synchronization, and understand how lead syncing works.
What you can do with the HubSpot integration
Once connected, you can:
Automatically create HubSpot contacts from Hunter leads (unsubscribed, do-not-contact and claimed addresses are skipped)
Sync lead activity (emails, opens, replies, etc.) from Hunter to HubSpot
Assign a Contact Owner in HubSpot
Optionally create deals for new leads
Manually sync specific leads when needed
Lead sync permissions
If you're part of a team, only the lead owner can sync a lead to HubSpot.
If a teammate created or saved a lead, only they can sync it
This applies even if the lead is in a shared list
👉 Workarounds:
Filter leads by team member to view only your own leads
Enable automatic synchronization so new leads are synced without manual action
How to connect Hunter to HubSpot
Start in Hunter and follow the steps below.
Step 1: Open the Integrations page
Go to the Leads section in your Hunter account
Click Integrations in the left sidebar
Step 2: Connect HubSpot
Find HubSpot in the integrations list
Click "Connect"
Step 3: Authorize your account
Log in to your HubSpot account
Enter your HubSpot credentials
Click "Authorize access"
Hunter redirects you back to configure the integration.
👉 Hunter's HubSpot contact sync runs on HubSpot's CRM v3 object API. If you connected before that change, HubSpot may ask you to authorize the connection again or approve additional permissions. That prompt is expected.
Step 4: Configure field mapping
Match Hunter lead attributes with HubSpot properties
Review and adjust default mappings as needed
What Hunter sends for a lead's location
On new connections, Hunter maps these by default:
Location country code → Country/Region
Location country code → Country/Region Code
Location city → City
Location state name → State/Region
Location state code (without country) → State/Region Code
A few things worth knowing:
State codes go to State/Region Code without the country prefix — "TX" for Texas, "BY" for Bavaria. The country sits beside it in Country/Region Code, so the two fields together identify the region.
Hunter leaves State/Region Code empty when a lead's state isn't a recognised code, or when it belongs to a different country than the lead's country. The two codes never disagree.
Hunter never sends a blank value. If a lead has no state, whatever HubSpot already holds stays as it is.
The company's country has no default mapping. It's in the picker as Company country code if you want it on the contact record.
👉 These defaults apply to connections created from 1 October 2026. If you connected before that, your mappings are untouched — you can add any of these yourself in your field mapping settings.
Working with Hunter inside HubSpot
Verifying a contact's email address on a HubSpot record is available through a separate app, Hunter Email Verification. It installs independently of this integration and adds a card to the contact record plus a workflow action for bulk verification. See Hunter Email Verification for HubSpot.
The other Hunter actions on HubSpot records — finding an email, running a Domain Search, saving a record to a Hunter leads list, or enrolling a contact in a Hunter sequence — aren't available yet. That card is built, but it has to pass HubSpot's own review before we can release it. Until then it won't appear in your HubSpot card library, and there's nothing to enable on your side.
In the meantime, find emails in Hunter itself — Domain Search, Email Finder, or the Chrome extension — and save them as leads. With automatic synchronization on, they're created as HubSpot contacts for you.
Synchronization between Hunter and HubSpot
There are several options available to configure your synchronization between Hunter and HubSpot:
You can configure whether you want leads to be updated in HubSpot when they are updated in Hunter and/or deleted from Hunter;
💡 Duplicate leads: If a contact with that email already exists in HubSpot, Hunter links the lead to the existing contact instead of creating a second one — so you won't end up with duplicates.
You can also select when leads should be added to HubSpot:
When a lead is saved in Hunter
When a lead is first contacted
When a lead replies
Only when I sync them manually
Only a real reply counts. Hunter matches replies in the email thread, so bounces and out-of-office auto-replies don't add the lead.
👉 In case you opt for a manual synchronization, a button will appear under "Synchronization" when you click on a lead's page. Click "Sync this lead" to manually update it in HubSpot.
If you already had existing leads before connecting Hunter with HubSpot, those leads won't be synchronized by default. Nonetheless, it's pretty simple to synchronize them in HubSpot by clicking the "Synchronize X leads" button on the integration's settings page;
Your synchronized leads can have a dedicated Contact Owner in HubSpot. To enable that option, select the assigned person from your team:
You can also create a deal in HubSpot every time a lead is created in Hunter by selecting the appropriate box.
When a lead isn't added to HubSpot
Hunter won't create a new HubSpot contact for a lead whose email address is unsubscribed, on a do-not-contact list, or has been claimed for removal from Hunter.
This applies to new contacts only. If the lead already matches a contact in HubSpot, that contact is still matched and updated as normal.
So if most of your leads are syncing and a few never appear as new contacts, that is why.
HubSpot Overview
Contacts
All of your synchronized leads will be available in the "Contacts" section of HubSpot:
Deals
If you selected the option to create a deal in HubSpot every time a lead is created in Hunter, you'll also be able to see your saved leads in the Sales dropdown menu under "Deals":
Activity Log
The Activity Log in HubSpot is updated every time the following triggers happen in Hunter:
When an email is sent
When an email sent has bounced
When an email was opened
When a tracked link was clicked
When a lead has replied
When a lead has unsubscribed
When a note was added
Click a specific lead in HubSpot to see all logged activities:
To sum things up
Connect Hunter to HubSpot from the Integrations page to start syncing leads automatically
Use field mapping and synchronization settings to control exactly how and when leads sync
Lead sync runs in the background once you've set it up — check the Synchronization column in Leads to confirm a lead reached HubSpot