In this guide we're going to show you how to verify email addresses of people and unsubscribe the ones that are not deliverable.

Set up API Key

To integrate Emailable with]( you'll need to create an API key. Head over to the [API Page

Once you've created your API key you'll be redirected back to the API Page and you should see a table that includes your newly created API key.

Set up webhook in

In you're going to create or edit an existing campaign. The webhook step will be part of the workflow in the campaign.

1. Start by adding a webhook to your workflow.

Now that you've created a webhook you're going to click on it and the sidebar should open. Click the Add Request button.

2. Set up the Request

You should now see a section with three tabs. (Request, Response, and Preview)

Type: POST

Make sure to replace api_key in the URL above with your API Key.

3. Set up the Response

Now click on the Response tab and click the Set up an attribute button.

For our use case we decided to map the following response data to the following fields

bv_state: {{response.state}}
bv_reason: {{response.reason}}
bv_free: {{}}
unsubscribed: {% if response.state == 'deliverable' %}false{% else %}true{% endif %}

You can review your attribute mappings and add any others you would like by reviewing the test response. Click the Send test... button in the right corner.


You've now setup webhooks to verify email addresses using Emailable. People that have email addresses that are not deliverable will automatically be unsubscribed.

For all campaigns that send email, you'll want to copy this webhook to be the first step in their workflows.
Was this article helpful?
Thank you!