How does the HubSpot integration work?

The HubSpot integration connects through OAuth — you authorize Valid Email Checker to read your contact lists, we verify the addresses, and (optionally) apply cleanup actions back to HubSpot. No API key to find or paste, no CSV export round-trip.

Connecting it

1. Open the dashboard. Click Integrations → HubSpot, or go to Bulk Upload → Connect Email Platform → HubSpot.
2. Give the connection a name if you want (default is "My HubSpot Account"). Helpful if you plan to connect multiple HubSpot portals.
3. Click Connect to HubSpot. You'll be redirected to HubSpot's OAuth page.
4. If you have multiple HubSpot accounts, pick the one you want to connect, review the read permissions we request, and click Choose Account.
5. You land back in our dashboard with HubSpot showing as connected. Your contact lists sync automatically.

Picking a list to verify

After connecting, you see all your HubSpot lists in a picker. Three flavors are available:

• All Contacts — your entire HubSpot contact database
• Static lists — manually curated, fixed-membership lists
• Active lists — dynamic lists whose members change based on filters

Two verification approaches

After picking a list, you choose how the verification should affect your HubSpot data:

Verify Only (default)

We import the list, verify every address, return detailed results. Your HubSpot data is completely unchanged. You review the results and decide what to do with them yourself. Useful when you want full control or you are evaluating list quality before committing to any cleanup action.

Clean list automatically

We verify the list and apply cleanup actions back to HubSpot based on rules you configure. Five result categories appear in the settings panel. Each has an Enable toggle and an Action selector (Keep / Unsubscribe / Delete).

The defaults are deliberately conservative — only the two unambiguously bad categories are enabled at start, with the more nuanced categories left disabled so they do not silently alter your data:

Unsubscribe means the contact stays in HubSpot but is marked unsubscribed and stops receiving marketing email. Delete removes the contact from the list entirely. Keep does nothing — leaves the contact untouched. You can override any default before starting the verification.

What we do and do not touch in HubSpot

• We only read your contact lists and (optionally) write the cleanup actions you configured.
• We only check the email field. Other contact properties (name, company, phone, custom fields) stay untouched.
• Contact activity history is preserved regardless of cleanup actions.
• We never send email through HubSpot or count against your HubSpot sending limits.

Multiple HubSpot accounts

Agencies and businesses with multiple HubSpot portals can connect more than one account. Go to Bulk Upload → Connect Email Platform → HubSpot → Add Another Account. Give each connection a clear name (client names, departments, regions). When verifying, you pick which connection to use.

Cost

One credit per address verified, same as anywhere else. The integration itself is free. You only verify contacts in the list you select, so you control the spend by picking the right list. For an active list filtered to "Create date is in the last 30 days," you verify just the newcomers — cheap monthly hygiene.