Skip to main content

Enrichment

Find verified emails and phone numbers for your contacts, and enrich a company's firmographics.

Contact enrichment runs through our provider Lemlist (with a FullEnrich fallback) on a pay-on-success basis — it's a routine lookup and runs directly. enrich_entity is different: it runs a Claude web-search pass and writes to the graph, so it previews and asks for confirmation first.


enrich_verified_email​

Find a verified professional email for one person.

Parameters​

NameTypeRequiredDescription
person_namestringYesThe person
entity_namestringYesTheir company
entity_typestringYesCompany entity type
linkedin_urlstringYesThe person's LinkedIn URL
first_namestringNoHelps matching
last_namestringNoHelps matching

Returns​

{ person_name, email, status, source }.

Example prompt​

"Find a verified email for the CMO of Decathlon"


enrich_verified_phone​

Find a verified phone number for one person. Same parameters as enrich_verified_email.


enrich_emails_batch / enrich_phones_batch​

Enrich a batch of contacts in one bulk call. Max 50 contacts per call.

Parameters​

NameTypeRequiredDescription
contactsobject[]YesEach: { person_name, entity_name, entity_type, linkedin_url, first_name?, last_name? }; contacts without a LinkedIn URL are skipped

Returns​

{ results: { linkedin_url: { email/phone, status, source } } }.


enrich_entity​

Enrich a company's firmographics via Claude web search and persist them to the graph. Runs a paid LLM + web-search pass, so it previews and asks for confirmation first.

Parameters​

NameTypeRequiredDescription
entity_namestringYesCompany name
entity_typestringYesEntity type
entity_urlstringNoCompany website to anchor research
target_fieldsstring[]NoNarrow which fields to research
languagestringNoOutput language (default "en")

Returns​

{ entity_name, entity_type, enriched_fields, from_cache }.