Skip to main content
POST
Enrich Lead
You can enrich a lead with additional data. The enrichment uses the data of the lead’s contact. A 409 ALREADY_ENRICHED answers when none of the requested workflows can add anything: the contact already has the data, a recent enrichment on the same inputs found nothing, verifyEmail is requested but the contact has no email, or the value was rejected as a CRM duplicate. force=true bypasses only the “already has the data” case. A lead already being enriched answers 409 until that enrichment is over, and force=true does not bypass it either. When the enrichment cannot be started, the answer carries a code and a message: see Request errors.
Check enrich data for details on the enrichment result structure.

Authorizations

Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

leadId
string
required

Unique lead ID

Query Parameters

findEmail
boolean

Find the lead's email. On when set to true.

verifyEmail
boolean

Verify the deliverability of the lead's email. On when set to true.

linkedinEnrichment
boolean

Enrich the lead's LinkedIn profile. On when set to true.

findPhone
boolean

Find the lead's phone number. On when set to true.

webhookUrl
string

URL that receives the enrichmentDone or enrichmentError event of this enrichment, on top of your team's webhooks. See the webhooks of the Enrichment object.

force
boolean

Re-run an enrichment that would otherwise be skipped. Bypasses skips caused by data already present on the contact: existing email, existing phone, LinkedIn enrichment already done for the same linkedinUrl / linkedinUrlSalesNav, or email already having a deliverability status.

Does not bypass:

  • Enrichment currently in progress — if another enrichment is already running for this contact, the request is still skipped (no parallel enrichments, no double billing).
  • Previously returned not-found — for findEmail and findPhone, if a prior enrichment with the same inputs (linkedinUrl, linkedinUrlSalesNav, first / last name, company name / domain / LinkedIn URL) already returned not-found, the request is still skipped. Changing any of those inputs on the lead lifts the block without needing force.

Response

Success

id
string

Enrichment ID