Integrate BounceBan using custom HTTP request

To ensure a smooth and reliable email verification process using custom HTTP request with services we don't have a native integration yet, we provide a dedicated API endpoint. This guide will walk you through the configuration process using Clay as an example. 

Note: We have native integrations for some popular automation services:

Clay: https://support.bounceban.com/article/how-to-use-bounceban-with-clay 

n8n: https://support.bounceban.com/article/how-to-use-the-n8n-node

Our waterfall API is specifically designed to handle the longer processing times that can sometimes occur with email verification, especially for difficult-to-verify emails.

• Endpoint URL: https://api-waterfall.bounceban.com/v1/verify/single.

• Timeout Behavior: The API will wait up to 80 seconds (default option, configurable) for a verification result. If the process is not complete within this time, it will return a 408 (Verification timeout) status code.

• Credit-Safe Retries: To get the final result, you simply need to retry the same request until you get the result. Retries for the same email made within 30 minutes of the initial request will not deduct additional credits.

Follow these steps to integrate BounceBan into your Clay table.

Step 1: Get Your BounceBan API Key

First, you'll need your unique API key. You can find this in your BounceBan account dashboard.

• Navigate to https://bounceban.com/app/api/settings to copy your API key.

Step 2: Configure the HTTP API Enrichment

1. In your Clay table, click Add column > Add Enrichment.

2. Search for and select HTTP API and go to the Configure tab.

Step 3: Set Up the API Request Details

In the configuration panel, enter the following information:

1. Method: Set this to GET.

2. Endpoint URL: Paste the dedicated waterfall API URL:

   https://api-waterfall.bounceban.com/v1/verify/single

3. Query Parameters:

   • Key: Enter email.

   • Value: Enter / to select the column in your table that contains the email addresses you want to verify.

4. Headers:

   • Click Add a new Key and Value pair.

   • Key: Enter Authorization.

   • Value: Paste your BounceBan API key from Step 1.

Step 4: Set Up Automatic Retries

This is a crucial step to handle the API's timeout behavior and ensure you get a result for every email.

1. Retry on failure: Make sure this is turned on (the default option). 

2. Max retries: Set this value to 5. This gives BounceBan ample opportunity to complete the verification.

3. Status codes to retry: You can leave this field empty. Clay automatically retries on 408 status codes by default. 

   • Note for other services: If you are using a different waterfall tool that does not automatically retry on a 408 status code, you should enter 408 into this field.

Once configured, run the enrichment. The API will now verify your emails, automatically retrying if a request times out, ensuring you get a complete and accurate verification result without being charged extra for the retries.

For more advanced configurations, please refer to the API reference: https://bounceban.com/public/doc/api.html#tag/Single-verification/paths/~1v1~1verify~1single%20(for%20waterfall)/get