Addressfinder

The best way to find exact addresses in New Zealand

  • Skip to Main Navigation
  • Skip to Footer Sitemap
  • Skip to Top
  • Pricing
  • Features
    • Autocomplete
      Search addresses and locations as you type
    • Bulk Cleansing
      Verify a database of addresses
    • Geocode Addresses
      Collect addresses and GPS coordinates together
    • Bounding Box
      Collect all addresses within a defined area
    • MORE FEATURES
  • About us
  • Case studies
  • FAQ
  • Contact
  • Blog
  • JavaScript widget docs
  • API developer docs
  • Pricing
  • Features
    • Autocomplete
      Search addresses and locations as you type
    • Bulk Cleansing
      Verify a database of addresses
    • Geocode Addresses
      Collect addresses and GPS coordinates together
    • Bounding Box
      Collect all addresses within a defined area
    • MORE FEATURES
  • More
    • Company & product
      • About Us
      • Case Studies
      • FAQ
      • Partners
      • Blog
      Contact Us
    • Integrations
      • Magento
      • WooCommerce
      • BigCommerce
      • Salesforce
      • Shopify Plus
      See all integrations
    • JavaScript widget docs
      • Integration Guide
      • Widget Code Generator
      • Widget Reference
      • Code Examples
      See all JavaScript docs
    • API developer docs
      • Address Autocomplete
      • Address Metadata
      • Address Verification
      • API Errors
      See all API docs
  • Login

Adding email verification to your form

The email verification widget is currently in alpha and not ready for production use. The widget can change at any time without prior warning. Please get in touch with us if you are interested in knowing more about the email verification features and how you can take advantage of them.

Installation Instructions

This page shows how to add Addressfinder’s email verification to a custom form.

The basic steps are:

  • Find the html identifiers of the email field or fields you want to apply validation to.
  • Copy/Paste the provided configuration script into your webpage.
  • Adjust the configuration to match your form elements and credentials.

Step by step

You should have an existing web form containing an email address field.

It should already be working well and collecting emails. We will enhance this form to enable email address verification.

We will verify the email address added by your user. There will be visual feedback with an icon and a warning/error message if appropriate. Visit our feature page to see it in action.

If you do not have ID value(s) assigned to the form element(s), you can also use CSS selectors to identify the element(s). For example, you might use selectors such as input[type=email] or input[name=email_address].

  
<script>
(function (d) {
  // **************************************************
  // Addressfinder settings
  // **************************************************

  // STEP BY STEP integration instructions here:
  // https://addressfinder.nz/email/integration-instructions/

  var conf = {
    // STEP 1 - update the property selectors using the ID attributes of your form fields
    addressSelector: "#email-address",


    // STEP 2: paste in your licence key
    licenceKey: "ADDRESSFINDER_DEMO_KEY",

    // STEP 3 (optional): customise the behaviour by adding some advanced options.
    // See integration instructions for the available options.
    rules: {
    }
  };

  d.addEventListener("DOMContentLoaded",function(){if(d.querySelector(config.addressSelector)){var e=d.createElement("script");e.src="https://api.addressfinder.io/assets/email/v1/widget.js",e.async=!0,e.onload=function(){new Addressfinder.Email(conf)},d.body.appendChild(e)}});
})(document);
</script>
  

Paste the provided configuration script

You should paste the configuration script into the source code of your webpage. We suggest that you include it at the bottom of the page.

Adjust the configuration

You should now set the ID value for your email field. Notice that the ID value has a # prefix which needs to be retained. If you are using a CSS selector, then this is not necessary.

Next, update the licenceKey value to use your key. You can obtain this value from the credentials link in the portal sidebar

Advanced options

It is possible to customise your email verification widget by including some rules in the configuration script. The widget can be set up to behave in a stricter or looser manner than the default.

There are four attributes that can be customised. Details of the available options and default values can be found in the email verification Javascript reference documentation.

Troubleshooting

Having trouble? Send us an email at support@addressfinder.nz, and we will have a look. Be sure to include the URL of the page, so we can see the page with the problem.

Next steps

Get Started Free

  • JavaScript Widget
    • Integration guide
    • Widget code generator
    • Code examples
    • Best practices
    • Fixing browser quirks
    • Advanced usage
    • Can't find your address?
    • JavaScript widget reference
  • Email Verification Services (ALPHA)
    • Email Verification API
    • Widget integration guide
    • Widget advanced usage
  • API Specs (NZ)
    • Address Autocomplete
    • Address Metadata
    • Address Verification
    • Address Reverse Geocode
    • Address Bounding Box
    • Location Autocomplete
    • Location Metadata
    • Points of Interest Autocomplete
    • Points of Interest Metadata
    • API Errors
  • API Specs (AU)
  • API Specs (INT'L)
  • Integrations
    • Magento
    • WooCommerce
    • BigCommerce
    • Salesforce
    • Shopify Plus
    • Hubspot
    • Spiffy Stores
    • Ruby
    • iOS
    • Drupal
    • Microsoft Dynamics 365
    • Vue
    • Gravity Forms
    • React
Addressfinder logo
Addressfinder provides speedy, accurate and dependable address autocompletion at a fair price. Easily integrate our address finder software with your site to start enjoying our address verification, address autocomplete and other address services today.

Sitemap

  • Home
  • About
  • Contact
  • Blog
  • FAQ
  • Pricing
  • Case Studies
  • Status Page
  • Privacy Policy
  • Terms & Conditions
  • Features
  • Address Metadata
  • Bulk Cleansing
  • Geocode Addresses
  • Reverse Address Lookup
  • Points of Interest
  • Street, Suburb & City Search
  • Bounding Box Search
  • Postcode Finder
  • Address Verification
  • Integrations
  • WooCommerce
  • BigCommerce
  • Shopify Plus
  • Magento
  • Salesforce
  • Spiffy Stores
  • iOS
  • Ruby
  • HubSpot
  • Drupal
  • Microsoft Dynamics 365
  • Vue
  • Gravity Forms
  • React
  • API Documentation
  • Address Autocomplete
  • Address Metadata
  • Address Verification
  • API Errors
  • Another 6 APIs
  • AU APIs specs
  • International APIs
  • Widget Documentation
  • Integration Guide
  • International Integration Guide
  • Code Generator
  • Code Examples
  • Javascript Reference
Addressfinder is also available in Australia
Terms and Conditions | Privacy
Copyright © 2022 Addressfinder, New Zealand