Guides01 July 2026

How to add email and phone verification lite to HubSpot

Email verification lite and phone verification lite are available on all active Addressfinder plans, including during your trial.

This guide covers how to add email and phone verification lite to your existing HubSpot form embed code.

Before you start, you'll need:

An Addressfinder account (active plan or trial)
Your Addressfinder licence key (find it under Credentials in the Addressfinder Portal)
An existing HubSpot form with region, portalId and formId
Your domain registered in the portal

Steps to integrate

Locate your existing HubSpot form embed code.
Copy your region, portalId and formId values.
Replace your existing second <script> block with the code snippet below.
Replace both instances of your_licence_key with your Addressfinder licence key.
Update portalId and formId with your values.
Update phoneInputSelector to match your phone field ID (see comment in snippet).
Set defaultCountryCode to your primary market (AU or NZ).
Add the URL of your website to the domains page in the Addressfinder Portal.

Not using this for Australia Post requirements? Update allowedCountryCodes and nonMobile to suit your markets, see the note below the snippet.

For advanced configuration options, see the HubSpot integration docs.

Code snippet

The following snippet is pre-configured with our recommended settings for meeting Australia Post's contact detail requirements.

Replace the placeholder values before going live.

<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/embed/v2.js"></script>
<script>
  hbspt.forms.create({
    region: "na1",
    portalId: "your_portal_id",
    formId: "your_form_id",
    onFormReady: function (form) {

      // Email verification lite
      var emailConf = {
        addressSelector: "input[type=email]",
        licenceKey: "your_licence_key",
        check: "format",
        rules: {
          unverified: {
            rule: "warn",
            message: "Please check and correct your email address."
          }
        }
      };
      if(form.querySelector(emailConf.addressSelector)){var e=document.createElement("script");e.src="https://api.addressfinder.io/assets/email/v2/widget.js",e.async=!0,e.onload=function(){var widget = new form.ownerDocument.defaultView.AddressfinderEmail.Email.Widget(emailConf.addressSelector, emailConf.licenceKey, emailConf); widget.on("result:verified", function(metadata){console.log(metadata)} )},form.appendChild(e)}

      // Phone verification lite
      var phoneConf = {
        licenceKey: "your_licence_key",
        phoneInputSelector: "#phone-your_form_id", // For externally-hosted forms use: input[name=phone]
        defaultCountryCode: "AU",
        allowedCountryCodes: "AU", // remove or update to support other countries, e.g. "AU, NZ"
        timeout: "1",
        verifyFormatOnly: true,
        rules: {
          unverified: {
            rule: "warn",
            message: "Please enter a valid Australian mobile phone number.",
          },
          nonMobile: {
            rule: "block",
            message: "Please enter a valid Australian mobile phone number.",
          },
          countryNotAllowed: {
            rule: "block",
            message: "Please enter a valid Australian mobile phone number.",
          }
        }
      };
      if(form.querySelector(phoneConf.phoneInputSelector)){var p=document.createElement("script");p.src="https://api.addressfinder.io/assets/phone/v2/widget.js",p.async=!0,p.onload=function(){var widget = new form.ownerDocument.defaultView.AddressfinderPhone.Phone.Widget(phoneConf.phoneInputSelector, phoneConf.licenceKey, phoneConf); widget.on('result:verified', function(metaData) { form.querySelector('input[name=fax]').value = metaData.formatted_international; }); },form.appendChild(p)}
    }
  });
</script>

The key setting for email verification lite is check: "format". For phone verification lite it is verifyFormatOnly: true. Both run format validation only, which is free on all active plans. Removing either param reverts to standard verification, consuming a lookup from your plan.

Lite only evaluates email format and syntax, so rules based on domain or account-level checks, such as disposable, role and public addresses, aren't available and will have no effect if added. These become available when using the full email verification service.

Serving other markets?

Update defaultCountryCode to your primary market and adjust allowedCountryCodes to include the countries you accept (comma-separated ISO2 codes, e.g. "AU, NZ"). Change nonMobile to warn or allow if you want to accept landlines as well as mobiles.

Note on phoneInputSelector

For HubSpot-hosted forms, the phone field ID follows the pattern #phone-{formId}. For externally-hosted forms, use input[name=phone]. To confirm the correct ID, right-click the phone field on your form, select Inspect, and copy the id attribute.

Adding address autocomplete too?

See the HubSpot address integration docs to add address autocomplete alongside email and phone verification.

Switching from full email or phone verification to Lite

Add check: "format" to your existing email config and verifyFormatOnly: true to your phone config.

Removing either param reverts to standard verification, which is a charged service.

For a guide on the full email and phone verification services in HubSpot, view the HubSpot address integration docs.

Start verifying data in minutes

30-day free trial. No credit card required. Cancel anytime.

Start free trial Talk to us