Skip to main content

HubSpot Integration

Connect your HubSpot CRM to Valid Email Checker and verify your contact lists without exporting a single file. Keep your CRM data clean, improve your email deliverability, and protect your sender reputation.


What You Can Do

With the HubSpot integration, you can:

  • Import contact lists directly from HubSpot for verification
  • Verify all contacts or specific lists/segments
  • Auto-clean your lists by removing or unsubscribing bad emails
  • Connect multiple HubSpot accounts (great for agencies)
  • Keep lists synced with on-demand refresh

No file exports. No manual uploads. Just connect and verify.


Before You Start

Make sure you have:

  • A Valid Email Checker account with available credits
  • A HubSpot account (Free, Starter, Professional, or Enterprise)
  • Admin or Super Admin permissions in HubSpot (to authorize third-party apps)
No API Key Required

HubSpot uses secure OAuth authentication. You don't need to find or copy any API keys - just click connect and authorize access directly in HubSpot.


Connecting Your HubSpot Account

Step 1: Start the Connection

You can connect HubSpot from two places:

Option A: From Integrations page

  1. Click Integrations in the left sidebar
  2. Find HubSpot in the Available Integrations section
  3. Click on the HubSpot card

Option B: From Bulk Upload page

  1. Click Bulk Upload in the left sidebar
  2. Click Connect Email Platform button
  3. Select HubSpot from the list

Step 2: Name Your Connection

Connect HubSpot modal showing connection name and OAuth flow explanation

In the connection modal:

  1. Connection Name (optional) - Give this connection a friendly name like "Marketing HubSpot" or "Client ABC HubSpot". Default is "My HubSpot Account"
  2. Notice the "How it works" info box - you'll be redirected to HubSpot to authorize access
  3. Click Connect to HubSpot

Step 3: Authorize in HubSpot

You'll be redirected to HubSpot's authorization page:

HubSpot OAuth page showing account selection for Valid Email Checker

  1. If you have multiple HubSpot accounts, select the one you want to connect
  2. Review the permissions Valid Email Checker is requesting
  3. Click Choose Account to authorize

You'll be redirected back to Valid Email Checker automatically.

What Permissions Do We Request?

Valid Email Checker requests read access to your contacts and lists so we can import them for verification. We never modify your HubSpot data unless you explicitly choose the "Clean list automatically" option.

Step 4: Connection Complete

Once authorized, your HubSpot account is connected and ready to use. Your contact lists will sync automatically.


Verifying Your HubSpot Contacts

Step 1: Select Your List

After connecting, you'll see your HubSpot lists:

HubSpot list selection showing contact lists with subscriber counts and verification options

  1. Search lists - Use the search box to find specific lists
  2. Select a list - Click on the list you want to verify (subscriber count shown)
  3. Choose your verification approach (see below)

Your HubSpot lists include:

  • All Contacts - Your entire contact database
  • Static lists - Manually curated contact lists
  • Active lists - Dynamic lists based on filters/criteria

Step 2: Choose Your Verification Approach

You have two options:

Option A: Verify Only

Select Verify only to:

  • Import and verify all emails in the list
  • Get detailed results for each contact
  • Review results before taking any action
  • Download results for your records

Your HubSpot list remains unchanged. You decide what to do with the results.

Option B: Clean List Automatically

Select Clean list automatically to have Valid Email Checker automatically update your HubSpot contacts based on verification results.

Configure what happens to each email type:

Email TypeOptionsDefault
InvalidKeep / Unsubscribe / DeleteUnsubscribe
DisposableKeep / Unsubscribe / DeleteDelete
Catch-allKeep / Unsubscribe / DeleteKeep
UnknownKeep / Unsubscribe / DeleteKeep
RiskyKeep / Unsubscribe / DeleteKeep
Understand the Actions
  • Keep - Contact stays in your list unchanged
  • Unsubscribe - Contact is unsubscribed from marketing emails but remains in your CRM
  • Delete - Contact is removed from the list entirely

Step 3: Start Verification

Click Import List to start

You'll be redirected to the Uploads & Results page.


Monitoring Verification Progress

Uploads & Results page showing HubSpot verification in progress

Track your verification in real-time:

ColumnDescription
Task IDUnique identifier (e.g., VECK6AVRRST)
List NameYour list name with HubSpot icon
Upload DateWhen verification started
Total EmailsNumber of contacts being verified
StatusProcessing, Completed, Failed, or Deleted
ProgressPercentage complete
ActionsView Results when done

Estimated Verification Times

List SizeEstimated Time
100 emailsSeconds
1,000 emails1-2 minutes
10,000 emails5-10 minutes
100,000 emails15-30 minutes
1,000,000 emails1-2 hours

The page updates automatically - no need to refresh.


Managing Your HubSpot Connection

Viewing Connected Accounts

Go to Integrations in the sidebar to see all your connected accounts:

Integrations page showing connected HubSpot account with management options

Each connection shows:

  • Provider - HubSpot
  • Connection Name - Your custom name
  • Status - Active or Disconnected
  • Connected - When you connected
  • Actions - Management options

Managing a Connection

Click the three-dot menu on any connection for options:

ActionWhat It Does
Sync NowRefresh your lists from HubSpot immediately
RenameChange the connection name
DeleteRemove this connection entirely

When to Sync

Your lists sync automatically when you connect. Use Sync Now when:

  • You've added new contacts to HubSpot
  • You've created new lists
  • You want to see updated subscriber counts
  • Lists aren't appearing as expected

Connecting Multiple HubSpot Accounts

Running an agency? Managing multiple HubSpot portals? No problem.

Multiple HubSpot connections modal showing existing connection and add new option

Adding Another Account

  1. Go to Bulk Upload and click Connect Email Platform
  2. Select HubSpot
  3. You'll see your existing connections
  4. Click + Add Another Account
  5. Give it a unique name (e.g., "Client XYZ HubSpot")
  6. Complete the OAuth authorization for the new account

Managing Multiple Accounts

When you have multiple HubSpot accounts:

  • Each appears as a separate connection in Integrations
  • Select the specific account when starting a verification
  • Use clear naming to keep track (client names, departments, etc.)

HubSpot-Specific Tips

Best Practices

  1. Start with "All Contacts" - Get a baseline of your entire CRM health
  2. Use Unsubscribe over Delete - Preserve your CRM history and contact records
  3. Verify new imports first - Check purchased or imported lists before they pollute your CRM
  4. Create a verification segment - Make an active list of unverified contacts for regular cleaning

Understanding HubSpot Contacts

HubSpot stores more than just email addresses. When you verify:

  • Only the email field is checked
  • Other contact properties (name, company, etc.) remain unchanged
  • Contact activity history is preserved

Working with Active Lists

Active lists in HubSpot are dynamic - contacts can enter or leave based on criteria. Keep in mind:

  • Verify active lists periodically as they change
  • Consider creating a static list snapshot for verification
  • Results reflect the list at the moment of verification

Troubleshooting

Connection Issues

ProblemSolution
Can't connect to HubSpotMake sure you have Admin permissions in HubSpot
Authorization failedTry logging into HubSpot directly first, then reconnect
Wrong account connectedDelete the connection and reconnect with the correct account
Connection shows "Disconnected"Re-authorize by clicking on the connection

List Issues

ProblemSolution
Lists not showingClick Sync Now to refresh
List shows 0 contactsCheck that contacts have email addresses in HubSpot
Missing some listsOnly lists you have access to in HubSpot will appear
"All Contacts" is hugeConsider verifying specific lists instead

Verification Issues

ProblemSolution
Verification stuckCheck the Uploads & Results page for status
Some emails failedPartial failures may occur - you can retry unprocessed emails
Results not syncing backEnsure you selected "Clean list automatically"

Frequently Asked Questions

Does Valid Email Checker modify my HubSpot data?

Only if you choose "Clean list automatically" and select Unsubscribe or Delete actions. With "Verify only," your HubSpot data remains completely unchanged.

What HubSpot plans are supported?

All HubSpot plans work - Free, Starter, Professional, and Enterprise. You just need permission to authorize third-party apps.

Can I verify contacts in HubSpot workflows?

Not directly through our integration. However, you can:

  1. Create a list of contacts that enter specific workflows
  2. Verify that list periodically
  3. Use the results to update your workflow criteria

How often should I verify my HubSpot contacts?

We recommend:

  • Monthly for active marketing lists
  • Quarterly for your entire database
  • Before every major campaign for critical sends
  • Immediately for newly imported contacts

Will this affect my HubSpot email sending limits?

No. Valid Email Checker verifies emails independently - we don't send any emails through HubSpot or count against your sending limits.

Can team members use this integration?

Yes! Team members in Valid Email Checker can use connected integrations. However, only the account owner can add or remove connections.


Next Steps


Need Help?

Having trouble with your HubSpot integration? We're here to help: