Artisan IMG > ZeroBounce (zerobounce) (68a09494-07e6-4480-925b-f69a252733c5)

ZeroBounce
1.0

ZeroBounce is an email validation and deliverability platform that helps organizations communicate more effectively through email.

Overview
Copy

ZeroBounce is a leading online email validation system created to ensure that companies sending complex and high volume emails avoid deliverability issues. The system works by reducing and eliminating invalid, abuse, complaint, inactive, and spam-trap email addresses.

Authentication
Copy

When using the ZeroBounce connector, the first thing you will need to do is go to your Tray.io account page, and select the workflow you wish to work on. Once in the workflow builder itself, search and drag the ZeroBounce connector from the Connector library (on the left hand side, click to expand the connectors panel) onto your workflow.

USER TIP: As an alternative to dragging a connector from the Connector library, you can add it as the next step in a workflow by double-clicking on it.

With the new ZeroBounce connector step highlighted, in the properties panel on the right, click on the Authenticate tab and 'Add new authentication' (located under the 'Authentication' field).

This will result in a Tray.io authentication pop-up window. The first page will ask you to name your authentication, and state which type of authentication you wish to create ('Personal' or 'Organization').

As you can see, the next page asks you for your 'API key'.

To find your API key, log in to your ZeroBounce account, and go to 'API - Keys & Info':

Then click on the 'Configure' icon for 'Your API Key':

There you will be able to generate a new API key and view any existing ones:

Once you have added these fields to your Tray.io authentication popup window, click on the 'Create authentication' button. Go back to your settings authentication field (within the workflow builder properties panel), and select the recently added authentication from the dropdown options now available.

Your connector authentication setup should now be complete.

Available Operations
Copy

The examples below show one or two of the available connector operations in use.

Please see the Full Operations Reference at the end of this page for details on all available operations for this connector.

Notes on using ZeroBounce
Copy

API LIMITATIONS: Please be aware that the main difference between validating your workflow in a production environment vs a testing one, is that production validations use up account credits. Simply put, Production validation: (normally) utilises one credit per validation. Whereas Sandbox validation: no account credits are used. Please take this into account when setting up your ZeroBounce environment.

Example Usage
Copy

TRAY POTENTIAL: Tray is extremely flexible. By design there is no fixed way of working with it - you can pull whatever data you need from other services and work with it using our core and helper connectors. This demo which follows shows only one possible way of working with Tray and the ZeroBounce connector. Once you've finished working through this example please see our Introduction to working with data and jsonpaths page and Data Guide for more details.

Imagine collecting email addresses for newsletter sign-ups. We can use the ZeroBounce connector to validate the email addresses and ensure that we only use genuine email addresses.

PLEASE NOTE: For this example, the email addresses being validated are part of the

Sandbox Mode

and do not use any credit. Please see the API Limitations warning above for more details.

We will use the 'Script' and 'Loop collection' connectors to simulate these email addresses being collected in real-time, which the ZeroBounce connector will validate one at a time as they are collected.

The steps will be as follows:

  1. Create a new workflow using a manual trigger

  2. Add the 'Script' connector and use the 'Execute Script' operation to provide a list of email addresses

  3. Add the 'Loop Collection' connector and use the 'Loop List' operation to loop through the list of email addresses

  4. Add the 'ZeroBounce' connector step and set up the 'Validate single email' operation to validate each email address

The final outcome should look like this:

1 - Create new workflow using a manual trigger
Copy

Once you have clicked 'Create new workflow' from your main Tray.io dashboard named it, select the Manual trigger from the trigger options available:

After clicking 'Create workflow' you will be redirected to the Tray.io workflow dashboard.

You are now ready to begin building your workflow.

2 - Execute Script
Copy

After you have been redirected to the Tray.io workflow dashboard, from the Connector library on the left, add a 'Script' connector to your second step. Set the operation to 'Execute Script'.

1
exports.step = () => [
2
{ "email": "valid@example.com" },
3
{ "email": "invalid@example.com" },
4
{ "email": "donotmail@example.com" },
5
{ "email": "spamtrap@example.com" }
6
]

Paste this into the 'Script' input field (note that you don't need to worry about the 'Variables' field in this example, and can in fact delete these fields for now).

Feel free to rename your steps as you go along to make things clearer for yourself and other users.

Before we continue, let's look at what output from the 'Execute Script' operation looks like.

Notice that the actual Output of the 'Execute Script' operation that is shown in the debug view does not match what appears in the Output tab of the 'Execute Script'.

This will be important later because we will want to jsonpath the value of 'email' as our input for the ZeroBounce connector.

Make it easier to jsonpath by clicking on 'Use output' as highlighted above. The Output tab of the 'Execute Script' operation now matches its actual output:

We have now set up the 'dummy data' for the workflow.

3 - Loop List
Copy

Next, find the 'Loop Collection' connector from the Connector library, and drag it into your workflow as your third step. Set your operation to 'Loop List'.

The 'Loop Collection' connector allows you to iterate through a list of results. In this example, we will use it to iterate through the data found within the previous 'Script' connector step.

In order to specify the list you want to loop through, start by using the 'List' mapping icon (found next to the list input field within the properties panel) to generate the connector-snake.

While hovering over the 'Execute Script' step (with the tail end of the connector-snake), select result from the list of output properties displayed. This will auto-populate a jsonpath within your 'List' input field, and update the type selector to jsonpath.

For more clarification on the pathways you have available, open the Debug panel to view your step's Input and Output.

JSONPATHS: For more information on what jsonpaths are and how to use jsonpaths with Tray, please see our pages on Basic data concepts and Mapping data between steps

CONNECTOR-SNAKE: The simplest and easiest way to generate your jsonpaths is to use our feature called the Connector-snake. Please see the main page for more details.

This step will now loop through the list of email addresses and output them one at a time.

4 - Validate single email
Copy

The last step is to drag the 'ZeroBounce' connector from the Connector library to your workflow.

Set the operation to 'Validate single email'.

As you can see, the 'Email' field is required.

Drag from the mapping icon (found next to the 'Email' input field within the properties panel) to generate the connector-snake. Continue dragging until the tail-end of the connector-snake hovers over the 'Loop List' step.

Release the mouse button and select email from the list of output properties displayed. This will auto-populate a jsonpath within your 'List' input field, and update the type selector to jsonpath.

Go to 'Debug' to see the results. As you can see, the 'Validate single email' operation returns useful information about each email address, such as whether they are valid:

BEST PRACTICES: Whenever you do decide to create your own workflow, be sure to check out some of our key articles such as: