Email Validation Integration for HubSpot Forms

Email Validation Integration for HubSpot Forms

The ZeroBounce HubSpot integration allows you to seamlessly import your HubSpot email lists for email validation, real-time validation, and Email Scoring.

Prerequisites

You must have an active HubSpot account, a website to integrate HubSpot forms and an active ZeroBounce account.

If you do not have access to the mentioned accounts, you can create them using the following links:

• Hubspot
• ZeroBounce

How to set up the HubSpot Forms integration

Once you have access to HubSpot and ZeroBounce, proceed with the following steps:

Step 1:

Go to https://www.zerobounce.net/members/signin and sign in with your ZeroBounce account. Then, go to the left menu and click Integrations.

The ZeroBounce members dashboard. The left menu includes Email Validation and Integrations.

Step 2:

On the Integrations page select HubSpot Form from the Integration List.

The ZeroBounce Integrations page with the HubSpot Form card highlighted in the integration list.

Step 3:

Click on the connect button In the HubSpot Form integration pop-up.

The HubSpot Form connection pop-up with the heading ‘Redirect to HubSpot Forms’ and Cancel and Connect buttons.

Step 4:

You will be prompted with a page which allows you to connect your ZeroBounce account to a new or existing HubSpot account.

Choose Sign in your HubSpot account to connect your ZeroBounce account to your HubSpot account.

The ZeroBounce HubSpot Forms connection page with the buttons ‘Create a new HubSpot account’ and ‘Sign in to your HubSpot account.’

Step 5:

Sign in to your HubSpot account and select the account you wish to link and click the button Choose Account

The ZeroBounce HubSpot connection page with a Choose an account list and an orange Choose Account button.

Step 6:

Review the permissions required by the app and click Connect app

The HubSpot permissions screen for ZeroBounce Integration for HubSpot Forms, with a Connect app button.

Step 7:

ZeroBounce Integration for HubSpot Forms is now installed in HubSpot and connected to your ZeroBounce account

The Configuration tab of ZeroBounce Integration for HubSpot Forms, showing a Connected banner and available credits.

Settings: Configuration, Forms, and Logs

App settings use three tabs. Until ZeroBounce is connected, Forms and Logs are locked and Configuration controls are read-only.

HubSpot Settings for ZeroBounce Integration for HubSpot Forms, with Configuration, Forms, and Logs tabs. Configuration is selected.

Configuration tab

Save with Save Changes at the bottom. Unsaved edits are not applied to new embeds until you save, then copy a fresh embed snippet from the Forms tab.

Connect ZeroBounce

• Control
  What it does

• Connect
  Starts the ZeroBounce linking flow (opens a new tab). Disabled after the portal is linked.
• Disconnect
  Unlinks ZeroBounce from this portal. The HubSpot app stays installed.
• Refresh status
  Re-checks whether this HubSpot portal is linked.

You must be connected before you can edit the rest of Configuration, open Forms, or open Logs.

Account credits

Shows Available credits on the linked ZeroBounce account. Use Refresh if you purchased credits and the number looks stale. Validation uses these credits.

Whitelist domains

Public form validation is allowed only from origins you list here.

• Rule
  Detail

• Format
  Full origin, for example https://example.com. No trailing slash, path, query, or wildcard. http or https only.
• Empty list
  No domains are allowed. Validation from your site will not run until you add the site origin and save.
• Limit
  Up to 50 origins.

1. Enter the origin of the page that hosts the form.
2. Click Add.
3. Click Save Changes.

If you embed the form on more than one hostname (apex and www, staging, and so on), add each origin.

General options

• Option
  What it does

• Throttle
  Maximum email validation attempts per hour on the form. Default is 10. Must be an integer of at least 1. Disabled while debug mode is on.
• Debug mode
  Turns off the hourly throttle so you can test without hitting the cap. Turn this off when you finish testing. Leaving it on lets visitors consume credits faster than expected.
• Custom Invalid Error Message
  Message shown when the email fails validation (up to 500 characters). If empty, the widget uses its default invalid message.
• Validate typos
  When on, ZeroBounce can suggest a correction (for example gnail.com → gmail.com).
• Typo error message
  Shown only when Validate typos is on. Your text is placed before the suggested correction (up to 500 characters).
• When to validate
  Choose one timing: Validate on blur (350 ms after the visitor leaves the email field) or Validate after idle typing (after they stop typing).
• Idle delay (seconds)
  Shown when idle validation is selected. Wait 1–60 seconds after typing stops before validating. Default is 1.
• Show ZeroBounce logo
  Shows the ZeroBounce logo on the validated form. Hiding the logo requires an active ZeroBounce One subscription.

Validation

These options decide which ZeroBounce results pass and whether free-mail addresses are allowed.

• Option
  What it does

• Email will pass on status
  The visitor can submit the form if the validation status is one of the checked values. Choose at least one. Recommended: Valid, Catch-All, and Unknown.
• Block free email services
  When on, addresses from free providers (Gmail, Yahoo, Outlook, and similar) fail validation even if the address is otherwise deliverable.

Email will pass on status

Passable statuses you can select:

• Valid
• Invalid
• Catch-All
• Unknown
• Spamtrap
• Abuse
• Do Not Mail

HubSpot Settings for ZeroBounce Integration for HubSpot Forms, with Configuration, Forms, and Logs tabs. Configuration is selected.

Forms tab

The ZeroBounce HubSpot Forms tab with the V4 marketing form list and Copy embed code control.

Use this tab after Configuration is saved.

1. Confirm the info banner: only new-editor (V4) marketing forms appear in the list.
2. Search by name or form ID if you have many forms.
3. Select the form in HubSpot form.
4. Click Copy embed code (or select the snippet and copy it).
5. Paste the snippet on your website where the form should appear.

If you change Configuration later, return here, copy the snippet again, and replace the old embed. The snippet includes your current validation settings.

Refresh forms reloads the V4 form list after you create a form in HubSpot.

If you see No V4 forms found, create a marketing form with the updated form editor (Marketing → Forms), then refresh. Legacy forms never appear here and cannot be validated by this app.

The embed is a HubSpot V4 developer embed (hs-form-html) plus the ZeroBounce V4 validation script. Do not mix this snippet with the legacy hbspt.forms.create / public API key widget.

Logs tab

The ZeroBounce HubSpot Logs tab showing validation totals, a status chart, and the recent validations table.

The Logs tab is available only while ZeroBounce is connected.

• Area
  What you see

• Totals
  Validation count and failed count for the last 2 weeks.
• Chart
  Daily validations stacked by status (Valid, Invalid, Catch-all, and other statuses).
• Recent validations
  Paginated table (25 per page): email, status, sub-status, time, View details.
• Details panel
  Full result for one validation (passed/failed, free email, did-you-mean, domain, MX, SMTP provider, and related fields).
• Export CSV
  Last 2 weeks of validations for this portal. If HubSpot does not return a file link, the export is copied to the clipboard.

Refresh reloads charts and the recent list after you test a form.

How validation works

A website form with a validated email address, a green checkmark, and the ZeroBounce logo.

A website form with a validated email address, a green checkmark, and the ZeroBounce logo.

Validation runs in the visitor’s browser on the embedded V4 form, using the script from the Forms tab and the rules you saved on Configuration.

Visitor types an email
        │
        ├─ Validate on blur  → wait 350 ms after leaving the field
        └─ Validate after idle typing → wait 1–60 seconds after typing stops
        │
        ▼
Is this page origin on the whitelist?
        │ no → validation does not run for that page
        │ yes
        ▼
ZeroBounce validates the address (uses account credits)
        │
        ├─ Typo check (if enabled) → show typo message + suggested correction
        ├─ Free-email block (if enabled) → fail free-mail addresses
        └─ Status vs “Email will pass on status”
                │
                ├─ Status is selected  → email passes; visitor can submit
                └─ Status is not selected → email fails; custom invalid message

What “pass” means

ZeroBounce classifies the address (Valid, Invalid, Catch-All, Unknown, and so on). The form allows submit only when that status is checked under Email will pass on status.

Example: if you keep the recommended set (Valid, Catch-All, Unknown), a result of Invalid or Spamtrap blocks submit and shows your invalid error message.

Timing

Blur (default): validation starts 350 milliseconds after the email field loses focus.

Idle: validation starts after the visitor stops typing for the idle delay (1–60 seconds).

You cannot enable both at once.

Whitelist

The widget only validates when the page origin matches an entry in Whitelist domains. Add https://www.yourdomain.com (and any other hosts you use) before you test on the live site.

Throttle and debug mode

Each successful validation attempt counts toward the hourly throttle. When the limit is reached, further attempts are limited until the hour resets. Debug mode removes that cap for testing.

Credits

Each live validation can use ZeroBounce credits (cached repeats may not). Watch Account credits on the Configuration tab. If credits run out, validation cannot classify new addresses until you add credits.

Logo

If Show ZeroBounce logo is on, the logo appears on the form. Turning it off requires ZeroBounce One.