How does the HubSpot integration work?

Last updated May 19, 2026Integrations

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.
You need HubSpot admin permissions
HubSpot requires Admin or Super Admin role to authorize third-party apps. If the connection fails at the authorization step, that is usually the cause. All HubSpot plans (Free, Starter, Professional, Enterprise) work — you just need the right permission level inside HubSpot.

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

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 action.

Clean list automatically

We verify the list and apply cleanup actions back to HubSpot based on rules you configure. Each of these five email types has three possible actions — Keep, Unsubscribe, or Delete — with sensible defaults:

  • Invalid — default Unsubscribe
  • Disposable — default Delete
  • Catch-all — default Keep
  • Unknown — default Keep
  • Risky — default Keep

Unsubscribe means the contact stays in HubSpot but stops receiving marketing email. Delete removes the contact from the list entirely. Keep does nothing. You can override any of the defaults 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.

Refreshing list data
Lists sync automatically when you connect. Use the Sync Now action on a connection if you have added new contacts to HubSpot, created new lists, or want to see updated subscriber counts before kicking off a verification.

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.