API Integrations

AWeber Integration

/api-integrations/aweber/

The AWeber integration service at Zerobounce allows users to import email addresses from their lists in AWeber and utilize our services to validate those emails.

When importing a list from AWeber to Zerobounce using the integration service, only the email address information in the AWeber list will be imported. Also, the subscriber’s status in your AWeber list needs to be “subscribed”.

To use this integration service, you need to have a valid AWeber account first. You will be prompted to enter your AWeber Login Name and Password when you use the service. We integrated our platform with AWeber using OAuth 1.0a for authorization. OAuth is a secure process that allows our application to access AWeber without passing user credentials. As your security is our priority at Zerobounce, we do not store your AWeber Login Name and Password; the access token issued by AWeber will be destroyed after you close the browser or log off from our website.

The following is an example on how to use the AWeber integration service.

  1. Have a valid AWeber account with your list ready.

    AWeber Account Dashboard
    AWeber Account Dashboard
  2. Log into Zerobounce, select ZB Integrations from menu, and select Connect for AWeber.

    ZeroBounce Dashboard
    ZeroBounce Dashboard
  3. Click OK to redirect to AWeber's authentication site.

    Redirect to Aweber link
    Redirect to Aweber link
  4. Enter your Login Name and Password. Click Allow Access to let ZeroBounce access your AWeber account.

    Aweber login screen
    Aweber login screen
  5. After you are authenticated, you will be able to see your lists from AWeber.

    Viewing your lists from the ZeroBounce dashboard
    Viewing your lists from the ZeroBounce dashboard
  6. Click the Verify link in the action column to import your list for validation. You will be prompted to confirm on a popup window. Click the OK button to proceed to the validation process or Cancel to exit.

    Verifying your Aweber lists
    Verifying your Aweber lists
  7. After clicking the OK button on the confirmation popup window, you will be redirected to the Download Your Results webpage. At this moment, the selected AWeber list has been successfully imported to Zerobounce and is waiting for the validation engine to process.

    ZeroBounce download results screen
    ZeroBounce download results screen
  8. Just like Upload a File for validation, you will receive a confirmation email for the imported AWeber list once the validation process is completed.

    Email confirmation message
    Email confirmation message
  9. To import your validation results back to AWeber, please follow theinstructions.

CloudFlare Integration

/api-integrations/cloudflare/

The Cloudflare ZeroBounce Subscription widget is a gathering and management tool which will help you achieve the highest quality subscriber lists, validating every subscriber in real-time. You can view and download your subscriber list directly from your ZeroBounce account.

It is fast & easy to install on any of your websites so let us guide you through the process.

  1. Navigate to CloudFlare and log in using your CloudFare Credentials.

  2. Click on "Apps" and then search for ZeroBounce Subscriptions and click on it.

    CloudFlare Dashboard Apps screen
    CloudFlare Dashboard Apps screen
  3. In order to customize and connect it with your ZeroBounce account you have to press on "Preview on your site".

    Click on "Preview on your site"
    Click on "Preview on your site"
  4. Scroll down on the left sidebar and click on "ZeroBounce Login" button.

    Find and click on the button shown above
    Find and click on the button shown above
  5. A new window will open where you will be prompted to login with your ZeroBounce account credentials.

  6. After you have successfully logged in, click on the "Install on all pages" button.

    Installing the App
    Installing the App
  7. Congratulations! You have now installed ZeroBounce Subscription widget on your website.

  8. You can view and download your subscription list from our platform clicking on "ZB Integrations" on the left hand menu. Then click on "CloudFlare".

    ZeroBounce Dashboard: Downloading and viewing your subscription list.
    ZeroBounce Dashboard: Downloading and viewing your subscription list.

Constant Contact Integration

/api-integrations/constant-contact/

The Constant Contact integration service at Zerobounce allows users to import email addresses from their lists in Constant Contact and utilize our services to validate those emails.

When importing a list from Constant Contact to Zerobounce using the integration service, only the email address information in the Constant Contact list will be imported. Also, the contact’s status in your Constant Contact list needs to be “Active”. We do not import any contacts with status of “Unsubscribed”.

Currently due to the limitation of the API, we do not export the validation results back to Constant Contact. This might change in the future when the required API functionalities are provided from Constant Contact.

To use this integration service, you need to have a valid Constant Contact account first. You will be prompted to enter your Constant Contact Username and Password when you use the service. We integrated our platform with Constant Contact using OAuth2 for authorization. OAuth2 is a secure process that allows our application to access Constant Contact without passing user credentials. As your security is our priority at Zerobounce, we do not store your Constant Contact Username and Password; the access token issued by Constant Contact will be destroyed after you close the browser or log off from our website.

The following is an example on how to use the Constant Contact integration service.

  1. Have a valid Constant Contact account with your list ready.

    Constant Contact dashboard: List management screen
    Constant Contact dashboard: List management screen
  2. Log into Zerobounce, select ZB Integration from menu, and select Connect for Constant Contact.

    ZeroBounce Dashboard: Integrations Screen
    ZeroBounce Dashboard: Integrations Screen
  3. Enter your Constant Contact Username and Password and click Log In.

    Enter your Constant Contact credentials in the pop-up modal
    Enter your Constant Contact credentials in the pop-up modal
  4. Click Allow to let ZeroBounce access your Constant Contact account.

    Constant Contact allow access screen
    Constant Contact allow access screen
  5. After you are authenticated, you will be able to see your lists from Constant Contact.

    View your Constant Contact lists from the ZeroBounce Dashboard
    View your Constant Contact lists from the ZeroBounce Dashboard
  6. Click the Verify link in the action column to import your list for validation. You will be prompted to confirm on a popup window. Click the OK button to proceed to the validation process or Cancel to exit.

    To import a list, click "Verify"
    To import a list, click "Verify"
  7. After clicking the OK button on the confirmation popup window, you will be redirected to the Download Your Results webpage. At this moment, the selected Constant Contact list has been successfully imported to Zerobounce and is waiting for the validation engine to process.

    Download your results page: Your selected list has been imported and is queued to be processed
    Download your results page: Your selected list has been imported and is queued to be processed
  8. Just like uploading a file for validation, you will receive a confirmation email for the imported Constant Contact list once the validation process is completed.

    Once validation has been completed, you will receive a confirmation email
    Once validation has been completed, you will receive a confirmation email
  9. To import your validation results back to Constant Contact, please follow the Instructions.

Drip Integration

/api-integrations/drip/

Prerequisites

You must have an active Drip account. If you do not have an account then you can create one at https://www.drip.com/

Getting started with Drip

  1. Go to www.zerobounce.net and login with your zerobounce account.

  2. Click on ZB Integrations in the left navigation menu

    ZeroBounce Dashboard
    ZeroBounce Dashboard
  3. On the Integrations page click on the Connect link on the Drip integration card.

    ZeroBounce Integrations Dashboard
    ZeroBounce Integrations Dashboard
  4. You will get an alert telling you that you will be redirected to the Drip authentication page. Click OK.

    Redirect pop-up modal
    Redirect pop-up modal
    Please wait a moment until the ZeroBounce API connects with Drip
    Please wait a moment until the ZeroBounce API connects with Drip
  5. On the Drip Sign In page you will enter your Drip email address and password to login.

    Drip login page
    Drip login page
    Enter your drip login credentials
    Enter your drip login credentials
  6. Once you enter your username and password you may be asked which account to authorize access. Choose an account you want to validate emails with and click Authorize.

    Choose the account you wish to authorize
    Choose the account you wish to authorize
    Drip access selection dropdown
    Drip access selection dropdown
  7. Once you have authorized access ZeroBounce will gather all of your email addresses for the account you selected during the authorization process. The emails are separated into the Drip statuses (Active, Inactive, Unsubscribed, Undeliverable).

    After successful integration, you will be able to view your lists in your ZeroBounce Dashboard.
    After successful integration, you will be able to view your lists in your ZeroBounce Dashboard.
  8. Choose a list validate. Click the verify link to start the verification process. Depending on how many emails you have to process it could take a few minutes to pull the list and add it to our processing queue.

    Click verify to import a list
    Click verify to import a list
  9. You will be asked if you want to continue and use your credits to validate. Click OK.

    Click to confirm the action.
    Click to confirm the action.
  10. You will be taken to the Email Validation Results page which will show the list you selected in queue.

    Email Validation results page
    Email Validation results page
  11. Once your list has completed processing you should receive an email notification and your processing status will change to Complete.

    Status: Completed
    Status: Completed

Hubspot Integration

/api-integrations/hubspot/

Prerequisites

You must have a valid HubSpot account with appropriate access to your Contacts and Lists.

Getting started in ZeroBounce

  1. Login to ZeroBounce

    Zerobounce Dashboard Home
    Zerobounce Dashboard Home
  2. Click on the ZB Integrations link in the left navigation menu

    Navigate to integrations page
    Navigate to integrations page
  3. On the ZB Integrations page click Connect on the HubSpot Integration card

    ZeroBounce Integration Dashboard
    ZeroBounce Integration Dashboard
  4. ZeroBounce will connect to HubSpot to get authorization. You will be prompted to login to HubSpot using your HubSpot credentials.

    Hubspot authetication modal
    Hubspot authetication modal
  5. You must choose the appropriate HubSpot account you would like to authorize access to your contact lists.

    Account authorization selection screen
    Account authorization selection screen
  6. Once you choose the appropriate account ZeroBounce will have authorization to your HubSpot lists.

    Authorization in process
    Authorization in process
  7. Please wait while ZeroBounce gathers information about your available lists.

    Please wait while our system fetches information
    Please wait while our system fetches information
  8. You are now able to verify a list. Just choose the list you want to validate and click the Verify link.

    Hubspot email list view
    Hubspot email list view
  9. Once you click "verify" you will be prompted to confirm.

    Click verify to validate the selected list
    Click verify to validate the selected list
  10. When you confirm you will see the loading screen. Please allow enough time for ZeroBounce to pull the entire list. Depending on the number of records in the list it could take an extended wait time. So please do not navigate away from the loading screen.

    List verification confirmation window
    List verification confirmation window
  11. When you confirm, the list will be moved into queue to be validated.

    List Status: Queued
    List Status: Queued
  12. You may check on the status of your file by going to the Download Your Results page

    List Status: Processesing
    List Status: Processesing
  13. Once the list has completed you will see the scoring in the Download Your Results page.

    List Status: Complete
    List Status: Complete

For more information about HubSpot please visit www.hubspot.com. For more information about importing files in HubSpot you can visit https://knowledge.hubspot.com/articles/kcs_article/contacts/set-up-your-import-file

Mailchimp Integration

/api-integrations/mailchimp/

The MailChimp integration service at Zerobounce allows users to import email addresses from their lists in MailChimp, utilize our services to validate those emails, and then export the validation results back to MailChimp.

When importing a list from MailChimp to Zerobounce using the integration service, only the email address information in the MailChimp list will be imported. Also, the subscriber’s status in your MailChimp list needs to be “subscribed”. We do not import any subscribers with statuses of “unsubscribed”, “cleaned”, or “pending”.

Only the lists imported from MailChimp will be able to export the validation results back to MailChimp. When exporting the validation results, instead of creating a new list at MailChimp, we only tag each subscriber in the list using the validation results. Seven tag names based on the validation status are used. They are ZB_Valid, ZB_Invalid, ZB_Abuse, ZB_Spamtrap, ZB_DoNotMail, ZB_Unknow, and ZB_CatchAll. We recommend filtering your MailChimp list by tag name ZB_Valid only before sending out your campaign.

To use this integration service, you need to have a valid MailChimp account first. You will be prompted to enter your MailChimp Username and Password when you use the service. We integrated our platform with MailChimp using OAuth2 for authorization. OAuth2 is a secure process that allows our application to access MailChimp without passing user credentials. As your security is our priority at Zerobounce, we do not store your MailChimp Username and Password; the access token issued by MailChimp will be destroyed after you close the browser or log off from our website.

The following is an example on how to use the MailChimp integration service.

  1. Have a valid MailChimp account with your list ready.

    MailChimp lists page
    MailChimp lists page
  2. Log into Zerobounce, select ZB Integration from menu, and select Connect for MailChimp.

    ZeroBounce Integrations Screen
    ZeroBounce Integrations Screen
  3. Enter your MailChimp Username and Password and click Log In.

    MailChimp login pop-up
    MailChimp login pop-up
  4. After you are authenticated, you will be able to see your lists from MailChimp.

    View your lists in the ZeroBounce DashBoard
    View your lists in the ZeroBounce DashBoard
  5. Click the Verify link in the action column to import your list for validation. You will be prompted to confirm on a popup window. Click the OK button to proceed to the validation process or Cancel to exit.

    Click to confirm list verification
    Click to confirm list verification
  6. After clicking the OK button on the confirmation popup window, you will be redirected to the Download Your Results webpage. At this moment, the selected MailChimp list has been successfully imported to Zerobounce and is waiting for the validation engine to process.

    Email validation results page
    Email validation results page
  7. Just like Upload a File for validation, you will receive a confirmation email for the imported MailChimp list once the validation process is completed.

    Email Confirmation that your list has been processed
    Email Confirmation that your list has been processed
  8. On the Download Your File webpage, click the file name when it is completed. Besides the standard options for Downloading a File, an “Export to MailChimp” button will be available if the file is imported from MailChimp.

    Export button to send your validated list back to MailChimp
    Export button to send your validated list back to MailChimp
  9. Click the Export to MailChimp button. You will be prompted to confirm on a popup window. Click the OK button to create tags for your MailChimp list or Cancel to cancel the operation.

    Export confirmation modal
    Export confirmation modal
  10. Click the OK button on the confirmation popup window to create tags based on the validation results for your list. After the process is finished, another confirmation popup window will show you the created tags.

    Successful export
    Successful export
  11. Go to the MailChimp website and select the list you just verified. You should see the tags created from our system associated with each subscriber.

    MailChimp lists page with new ZB tags
    MailChimp lists page with new ZB tags
  12. On the list view at MailChimp, click the Filter by Tags dropdown menu and select a tag to filter your list.

    MailChimp tags filter
    MailChimp tags filter
  13. The following shows the returned list filtered by the “ZB_Valid” tag. You can then click on the Send Campaign dropdown menu and select the campaign type you want.

    Filter Lists by Tag
    Filter Lists by Tag

Marketo Integration

/api-integrations/marketo/

This is a set of instructions on how to integrate with Marketo. This is to create a webhook within your Marketo environment to get the benefits of ZeroBounce email validation in real-time.

Getting started with Marketo For more documentation about Marketo please take a look at their docs. https://docs.marketo.com

Custom Fields Setup

  1. Go to your Marketo My Dashboard

    Marketo Dashboard
    Marketo Dashboard
  2. Click on Admin on the top menu and click on Database Management -> Field Management

    Click the admin button on the top right.
    Click the admin button on the top right.
    Click on field management
    Click on field management
  3. Create a New Custom Field.

    You will need to create custom fields in Marketo to match the API results from the ZeroBounce API.

    Click on new custom field
    Click on new custom field
  4. Fill in the popup form with the appropriate data type in reference to each property found on the ZeroBounce API result.

    Fill out new custom field with appropriate values
    Fill out new custom field with appropriate values
  5. Ensure that all of the properties are created by searching for “ZB” in the Fields Management Fields search bar on the right pane.

    Verify that the correct fields have been created on the right
    Verify that the correct fields have been created on the right

List Setup

  1. Go to the Marketo Database so we can create a new Group List or Group Smart List.

    Click on Admin and on the left pane click on "webhooks". You should now see ZeroBounce in your list of available webhooks
    Click on Admin and on the left pane click on "webhooks". You should now see ZeroBounce in your list of available webhooks
  2. Once we are on the Lead Database screen you can create a new Group folder by right-clicking Group Lists and choose New Folder

  3. Create a new List by choosing New -> New List in the Database top menu.

  4. Fill in the New List form

    Create new list window
    Create new list window

WebHook Setup

  1. Once we have successfully created our list we can now start working on our ZeroBounce Webhook. We want to go to our Marketo Admin by clicking on Admin on the top menu and then clicking on Integration -> Webhooks on the left navigation menu.

    Click on the WebBooks link on the right side of your Marketo Dashboard
    Click on the WebBooks link on the right side of your Marketo Dashboard
  2. Click on Webhooks in the left navigation menu under the Integration section

    Select WebHooks on the left pane
    Select WebHooks on the left pane
  3. WebHooks Screen: Click on the new WebHook button

    WebHooks Screen: Click "New WebHook
    WebHooks Screen: Click "New WebHook
  4. Fill out the form with the following information:

    • Webhook Name: ZeroBounce
    • Description: ZeroBounce Email Validation Webhook
    • URL: You will need to generate a new API key in ZeroBounce. https://api.zerobounce.net/v2/validate?api_key=8a42b102c171439ca78e2140bf3f8cc9&email={{lead.Email Address}}&ip_address={{lead.Anonymous IP}}

    Please notice there are 3 parameters that you will pass in the URL.

    1. api_key - This comes from your ZeroBounce API (https://www.zerobounce.net/members/apikey/)
    2. email - this information is filled by Marketo by using the “'{{lead.Email Address}}” token
    3. ip_address - this information is filled by Marketo by using the “{{lead.Anonymous IP}}” token

    Once the form is filled out completely click the Create button.

    New WebHook Form
    New WebHook Form
  5. You should now see ZeroBounce in your list of available webhooks

    ZeroBounce WebHook in Marketo dashboard
    ZeroBounce WebHook in Marketo dashboard
  6. Now that we have our Webhook we still need a way to handle the ZeroBounce API results. We need to map those results from ZeroBounce API to Marketo fields that we created earlier.

    In the Response Mappings section click Edit.

    Edit the response mapping on your webhook
    Edit the response mapping on your webhook
  7. Click Add to add each property mapping from ZeroBounce API to Marketo custom fields.

    Click Add to add each property mapping from ZeroBounce API to Marketo custom fields.
    Click Add to add each property mapping from ZeroBounce API to Marketo custom fields.

    • Response Attribute
      Marketo Field
    • account
      zbAccount
    • address
      zbEmailAddress
    • city
      zbCity
    • country
      zbCountry
    • did_you_mean
      zbDidYouMean
    • domain
      zbDomain
    • domain_age_days
      zbDomainAgeDays
    • error
      zbError
    • firstName
      zbFirstName
    • free_email
      zbFreeEmail
    • gender
      zbGender
    • lastName
      zbLastName
    • mx_found
      zbMxFound
    • mx_record
      zbMxRecord
    • processed_at
      zbProcessedAt
    • region
      zbRegion
    • smtp_provider
      zbSmtpProvider
    • status
      zbStatus
    • sub_status
      zbSubStatus
    • zipcode
      zbZipCode
    Response Mapping List
    Response Mapping List
    Completed response mapping screen
    Completed response mapping screen

Forms Setup

  1. Now that we have our mappings setup we can now create our forms. Go to your Marketo Design Studio.

    Marketo Dashboard: Click "Design Studio
    Marketo Dashboard: Click "Design Studio
  2. Let’s create a new form. In the Design Studio click on New -> New Form.

    Design Studio: Click on New and Choose New Form
    Design Studio: Click on New and Choose New Form
  3. Fill out the New Form popup and click Create.

    New Form window
    New Form window
  4. We can stick to the default settings for the form. Click Finish. Then click Approve and Close.

    Click Finish once your are completed
    Click Finish once your are completed

Landing Page Setup

  1. Let’s create our Landing Pages. Let’s create a Thank You page. Within the Design Studio click New -> New Landing Page.

    Select Design Studio on the left pane
    Select Design Studio on the left pane
    Select New Landing Page under the "new" dropdown
    Select New Landing Page under the "new" dropdown
  2. Fill in the New Landing Page popup form and click Create.

    New landing page form window
    New landing page form window
  3. In the editor click and drag the Rich Text box over to the page container and type in a Thank You message and save the design and ensure to click Approve and Close.

    Landing page editor window
    Landing page editor window
  4. Let’s create one more Landing Page. From the Design Studio click New -> New Landing Page.

    Create a new landing page
    Create a new landing page
  5. Fill in the New Landing Page popup form and click Create.

    Fill out "New Landing Page" form
    Fill out "New Landing Page" form
  6. Click and drag the Form element to the editor container.

    Drag the form element from right pane in "Design Studio"
    Drag the form element from right pane in "Design Studio"
  7. Fill in the Insert New Form popup and choose the ZeroBouce Test Form we created earlier.

    Select the previous Landing Page you created
    Select the previous Landing Page you created
  8. Once we are finished setting up our Landing Page. Click the Landing Page Actions menu and choose Approve and Close.

    Select "Landing Page Actions" on the left pane
    Select "Landing Page Actions" on the left pane

Campaign Setup

  1. Let’s setup a campaign. From the Marketo Logo menu click on Marketing Activities.

    "Select Marketing Activities" on the left pane
    "Select Marketing Activities" on the left pane
  2. Click on New -> New Smart Campaign.

    Select "New Smart Campaign"
    Select "New Smart Campaign"
  3. Fill in the New Smart Campaign form and click Create.

    New Smart Campaign form
    New Smart Campaign form
    Newly created smart campaign
    Newly created smart campaign
  4. Click on Smart List in the top navigation for our campaign. Click and drag Fills Out Form over to the editors box.

    Select "Smart List" on the top navigation next to your Campaign name and then select "Fills Out Form" in the right pane
    Select "Smart List" on the top navigation next to your Campaign name and then select "Fills Out Form" in the right pane
  5. Fill in the information to use our new ZeroBounce Test Form we created earlier.

    "Smart List > Fill Out Form" screen
    "Smart List > Fill Out Form" screen
  6. Click on Flow as the next step in the top navigation and select "Call WebHook" on the right pane.

    Select "Flow" on the top campaign‘s top nav
    Select "Flow" on the top campaign‘s top nav
  7. Fill in the webhook information for the webhook we created earlier.

    Call WebHook form
    Call WebHook form
  8. Next, click and drag the Add to List to the Flow editor.

    Drag "Add to List" from the right pane to the main window below the "Call WebHook" flow you created
    Drag "Add to List" from the right pane to the main window below the "Call WebHook" flow you created
  9. Fill in the information so that we are using the ZeroBounce Test List we created earlier.

    Fill "List Name" with our previously created list
    Fill "List Name" with our previously created list
  10. It’s now time to test your webhook.

Setup Complete

You can now test your webhook by activating the Landing Page you created earlier.

Shopify Integration

/api-integrations/shopify/

Prerequisites

You must have an active Shopify Store account. If you do not have an account then you can create one at https://www.shopify.com/

You should also get the store name because you will need it to login. When you login to your Shopify store you will see the name in the URL within the browser address bar (e.g., storename.myshopify.com).

Getting Started with Shopify

  1. Go to www.zerobounce.net and login with your zerobounce account.

  2. Click on ZB Integrations in the left navigation menu

    ZeroBounce Dashboard: Click on ZB Integrations
    ZeroBounce Dashboard: Click on ZB Integrations
  3. On the Integrations page click on the Connect link on the Shopify integration card.

    ZeroBounce INtegrations Page
    ZeroBounce INtegrations Page
  4. You will be taken to a page to enter your Shopify Store name as mentioned earlier. You can find it in your store URL when you login to your Shopify store as an administrator (e.g., mystorename.myshopify.com). Once you have entered your store URL click Connect My Store to continue with the store authentication.

    Shopify Integration screen
    Shopify Integration screen
    After clicking please wait a moment while our system connects to Shopify
    After clicking please wait a moment while our system connects to Shopify
  5. You will be prompted to enter your email and password for you Shopify store.

    Shopify Login Screen
    Shopify Login Screen
    Once logged in, Shopify will then connect to ZeroBounce
    Once logged in, Shopify will then connect to ZeroBounce
  6. You will have to confirm installation of the ZeroBounce - Email Validation App

    Shopify installation confirmation
    Shopify installation confirmation

    Once the installation of the ZeroBounce App is completed you will be redirected back to ZeroBounce. You should see a list called “Shopify Customers” and the number of contacts found.

    ZeroBounce Shopify screen
    ZeroBounce Shopify screen
  7. Click the verify link to start the verification process. Depending on how many emails you have to process it could take a few minutes to pull the list and add it to our processing queue.

    Click verify to validate your selected Shopify list
    Click verify to validate your selected Shopify list
  8. You will be asked if you want to continue and use your credits to validate. Click OK.

    Verify you wish to use specified credits to verify the list
    Verify you wish to use specified credits to verify the list
  9. You will be taken to the Email Validation Results page which will show the list you selected in queue.

    Email Validation results page
    Email Validation results page
    Validation progress... your selection will be queued and you will be notified of the progress.
    Validation progress... your selection will be queued and you will be notified of the progress.
  10. Once your list has completed processing you should receive an email notification and your processing status will change to Complete.

    Once completed, you will be notified by email
    Once completed, you will be notified by email