Skip to main content
Find the missing emails for leads in a lead list, using the workspace’s own connected enrichment provider (Prospeo or Apollo — BYOK). Runs as a background job so large lists don’t block.
Always two steps. Call it first without confirm to get a free dry-run cost preview — how many leads are chargeable, how many already have an email on file (free), the provider, and the estimated cost. Report that to the user and get their go-ahead. Then call again with confirm: true to actually run it. Nothing is spent on the preview.
Select leads with filter rather than listing ids — filter is resolved server-side across the whole list, not just one page. With neither filter nor ids, it defaults to every lead missing an email (the usual case). Call lead_list_operations with no id first to find the list’s UUID.

​
Parameters

NameTypeRequiredDescription
lead_list_idstringyesThe lead list’s UUID.
filterobjectPick leads by attribute, e.g. { "emailStatus": "none" } (missing an email — the default) or { "domain": "has", "emailStatus": "none" } (has a company domain but no email).
idsstring[]Explicit lead ids — an alternative to filter.
confirmbooleanOmit or false = dry-run cost preview only (spends nothing). true = run it as a background job.

​
Returns

Preview (no confirm): 
ENRICH PREVIEW — list 6149…2c6
  1,205 selected · 186 chargeable · 1,019 already on file (free) · 0 no identifier
  provider: prospeo
  estimated cost: ~$1.86

Report this to the user. To run it, call enrich_leads again with the same selection and confirm:true.
Confirmed run (confirm: true): 
Enrichment started — job 9f2c…, 186 leads queued. It runs in the background; report back to the user that it's running.

​
When to call it

  • The user wants to fill in missing emails on a lead list before outreach.
  • Always preview first, surface the cost, and only run on the user’s go-ahead.

​
Backed by

POST /api/lead-lists/:id/enrich — preview: true for the dry run, background: true for the job. Reuses the 90-day reuse-gate (a lead enriched recently anywhere is free). See also verify_leads for validating the emails afterwards.