Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.enrichley.io/llms.txt

Use this file to discover all available pages before exploring further.

Enrichley and Clay work together in two complementary ways:
  1. Enrichley as a data provider in Clay — call Enrichley’s email validation from inside Clay tables, paying with either Clay credits or your own Enrichley credits.
  2. Push to Clay from Enrichley — after running a validation job in Enrichley, push the results into a Clay table via webhook.
You can use one or both depending on how your team works.

​
Enrichley in Clay

Use Enrichley as one of Clay’s enrichment providers. Inside any Clay table, add an Enrichley enrichment to validate emails alongside the rest of your Clay workflow.

​
Why use your own Enrichley API key

Clay supports two billing modes for Enrichley enrichments:
ModeHow you payWhen to choose it
Clay-managed account (default)Clay creditsOne-off testing, no Enrichley account
Your own API key (recommended)Enrichley creditsYou already have an Enrichley plan and want to save money — Enrichley credits are typically much cheaper than Clay’s bundled credits

​
Plan requirements

You can use Enrichley in Clay without an Enrichley account by paying with Clay credits. To use your own API key, you need any paid Enrichley plan.

​
Setup

1

Get your Enrichley API key

Sign in to Enrichley and copy your key from your profile.
2

Add an Enrichley enrichment in Clay

In your Clay table, click Add Enrichment and search for Enrichley.
3

Connect your Enrichley account

Click Add new account → Use your own API key → paste your Enrichley API key.
4

Run the enrichment

Pick the column to validate and run the enrichment. Validations consume your Enrichley credits, not Clay credits.
Place Enrichley early in your Clay waterfalls. High validation accuracy means fewer fallback calls to expensive backup providers.

​
Push to Clay

Run a validation job in Enrichley, then push the results to a Clay table via webhook. Useful when Enrichley is your validation hub and Clay is where your team operates downstream.

​
Plan requirements

A paid Enrichley plan is required.

​
Setup

1

Create a webhook source in Clay

In Clay, create or open the table you want to receive validated rows. Add a Webhook source and copy its URL — it will look like https://api.clay.com/v3/sources/webhook/....
2

Run a validation job in Enrichley

Upload a list to Enrichley and run email validation. Wait for the job to complete.
3

Open the Push to Clay dialog

From the completed job’s actions, click Push to Clay.
4

Paste the Clay webhook URL

Paste the webhook URL you copied from Clay.
5

Choose which emails to send

Pick Valid only (only emails marked ok or catch_all_validated) or All emails (every result, including invalid and unknown). Click Submit to start the push.

​
What gets pushed

Each row is sent to Clay as a JSON object with the original input columns plus Enrichley’s validation fields:
  • email — the email that was validated
  • result_status — ok, catch_all_validated, catch_all, invalid, or unknown
  • valid — boolean
  • mx_domain, mx_provider, email_type — MX and classification info
  • Plus any custom columns from your original input

​
Reliability

Enrichley retries failed pushes automatically (up to 3 attempts per row, with exponential backoff) and respects Clay’s rate-limit response. If a row can’t be delivered after retries, it’s logged so you can re-run the push or contact support.
Enrichley does not store your Clay webhook URLs. You’ll paste the URL each time you push a job.

​
Get help