Contacts
Enrichment
v1
Create Find Contact Data Job
Trigger an asynchronous job to enrich the given contacts with email and phone data. Accepts either explicit contact_ids or a list_id to target an entire list. The job runs in the background; poll the status endpoint to check progress. Credit Note: Credits are consumed as contacts are enriched.
:::info Requires the contacts:read OAuth2 scope. :::
post/v1/contacts/find-contact-data-jobs
Query parameters
account_idstring required
The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.
Request body
Response
Job accepted and started
Example response
{
"data": {
"type": "find_contact_data_job",
"id": "job_550e8400",
"attributes": {
"status": "running",
"errors": [
{
"code": "job_failed",
"title": "External contact data provider timeout"
}
],
"created_at": "2026-03-10T12:00:00Z",
"completed_at": "2026-03-10T12:01:42Z"
}
},
"meta": {
"request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
}
}