This guide walks you through integrating   ListClean’s email verification API with your Clay workspace. Once connected, you can automatically validate emails inside Clay using your ListClean account — no coding required.

📋 What You Need

Before getting started, make sure you have:

• ✅ A ListClean API Key

• ✅ A Clay account

• ✅ A Clay table with an email column

• ✅ Authorization to use Clay’s HTTP API action

🧩 Step 1: Create Your Clay Table

Start by creating a new Clay table with at least one column named Email.

✅ Ensure the email column is correctly named so it can be used as a dynamic variable in the API request.

Example:

➕ Step 2: Add a New Column for the API Action (HTTP API Enrichment)

1. Click on ➕ Add column

2. Select “Add enrichment”

3. Choose the “HTTP API” option

Example:

• Add Enrichment

• Then “HTTP API”
  

🔐 Step 3: Set Up the API Authentication

a. Connect your ListClean API token:

1. In the HTTP API setup panel, click “+ Add account”

2. Set the auth type to Header

3. Fill the fields as follows:

• Key: X-Auth-Token

• Value: your_ListClean_API_key

🔐 Your API key can be found in your ListClean dashboard under the API section.

Example:

In the HTTP API setup panel, click “+ Add account”

Set the auth type to Header:

API Request Headers
Name your connection: Give name to this connection
Key: X-Auth-Token
Value: Enter Listclean API Key

🌐 Step 4: Configure the API Request

Once the account is connected, complete the following fields:

• Method: GET

• Endpoint: https://api.listclean.xyz/v1/verify/email/ [select_your_email_column]

📌 Replace [select_your_email_column] with the dynamic column field in Clay. Clay will automatically inject the row-specific email.

✅ Do not include a body for this request.

📤 Step 5: Map the Output (Optional)

When the API returns a response, you can map fields like:

{
"data": {
"email": "[email protected]",
"status": "dirty",
"remarks": "Email does not exists"
},
"message": "Email verification completed!",
"success": 1,
"error_code": 0
}

You can now write these values into your table.
In the output mapping section, do the following:

Now your Clay table is connected to ListClean, and emails will be checked as you add them.

You can:

• Run the enrichment per row

• Or select multiple rows and run in batch