Skip to main content
POST
Add a Sourced Contact
Takes a leadId from a run’s contacts array and creates the matching contact in your workspace.

Filing and enriching

  • listId files the new contact into a contact list. Without it the contact lands in All contacts.
  • findEmail: true also runs email enrichment on the new contact. It spends enrichment credits, so it is off by default.

Why companyId is required

The People Database resolves a person’s company from their own profile. If the person has changed jobs since the run, they belong to a different company than the one you sourced — so lemlist checks, and answers 409 rather than filing them under the wrong account and reporting success.

Authorizations

Authorization
string
header
required

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

Body

application/json
leadId
string
required

People-Database id, from a run's contacts[].leadId.

Example:

"123456789"

companyId
string
required
Example:

"cpn_K4tRm2Qw9Yb7Xz1Ns"

listId
string

File the new contact into this contact list (clt_xxx). Omit to leave it in all contacts.

Example:

"clt_P3vDh8Lk5Tq2Wm6Rj"

findEmail
boolean
default:false

Also run email enrichment on the new contact. Spends enrichment credits.

Response

Contact created.