Skip to content

Clay

Clay’s HTTP API enrichment calls ValidationCheck for every row and turns the answer into columns.

  1. In your table, Add enrichment → HTTP API.

  2. Method POST, Endpoint https://api.validationcheck.net/v1/email (or /v1/phone, /v1/ip, /v1/check).

  3. Headers: Authorization = Bearer vc_live_… and Content-Type = application/json.

  4. Body:

    { "email": "/Email" }

    Type / to insert your email column. For phones: { "phone": "/Phone", "country": "US" }.

  5. Under Run settings, add the condition Email is not empty, so empty rows don’t run.

  6. Set the rate limit to your plan’s requests per second (Free 2, Starter 20, Growth 50, Scale 100, Volume 200).

  7. Save and run on a few rows, then Add columns from response:

Column Response field
Action data.recommendation.action (approve, verify, review, block)
Status data.verdict.status
Reason data.verdict.reason
Risk score data.risk.score
Disposable data.details.is_disposable
Credits used data.metadata.credits_used
  • Re-running a table within 7 days is free for rows already checked (cache_hit: true).
  • Empty optional fields are fine: "" is treated as not set.
  • Errors come back as success: false with a code, such as INSUFFICIENT_CREDITS; nothing is charged for them.
  • Build with a vc_test_… key first; test mode lists inputs with known answers.