HAharmonic
email_enrichment

Submit Job

Changed on

Submit a bulk email enrichment job.

Accepts exactly one of person_linkedin_urls or person_urns. Returns 202 with the created job_id and a list of any people that were dropped at submit time (with reasons). Returns 422 when no submitted people are eligible for enrichment, and 429 when the request requires more enrichment credits than remain in your monthly quota.

With allow_re_enrichment, people who already have an email stay eligible and enrichment re-runs for them, adding any newly found addresses to the profile; the 30-day cooldown still applies.

post/email_enrichment/jobs

Request

Request body

person_linkedin_urlsstring[] nullable
person_urnsstring[] nullable
allow_re_enrichmentboolean

When true, people who already have an email are not dropped as ALREADY_HAS_EMAIL; enrichment re-runs for them and any newly found addresses are added to the profile. The 30-day RECENTLY_ATTEMPTED cooldown still applies.

Response

Successful Response

job_idstring uuid required
status'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' required
accepted_countinteger required
monthly_remaininginteger required
created_atstring required

Changes