Skip to main content
POST
Find LinkedIn profiles

Authorizations

Authorization
string
header
required

Your API key, sent as is (no Bearer prefix). Create it in the Leadsforge app under Settings -> API & MCP.

Headers

Idempotency-Key
string

Idempotency key - a repeat with the same key for the same channel returns the existing job as is; it can still get 429 from the rate limit, retry it with the same key

Body

application/json

Find request

Find request

clientRequestID
string
Maximum string length: 128
Example:

"my-request-123"

people
object[]
Required array length: 1 - 500 elements
personIDs
string[]
Required array length: 1 - 500 elements
saveToList
boolean

SaveToList, when true, also shows this job as a list on the Enrichments page of the Leadsforge app. Default false.

Example:

false

webhookURL
string
Example:

"https://example.com/webhook"

Response

Job created

channel
enum<string>
Available options:
email,
phone,
linkedin
clientRequestID
string
completedAt
string
consumedCredits
number
createdAt
string
failed
integer
jobID
string
processed
integer
reservedCredits
number
resultsURL
string

ResultsURL is the path of this job's results on the API host, e.g. /public/v1/enrichment/jobs/{jobID}/results.

status
enum<string>
Available options:
in_progress,
completed,
failed
statusURL
string

StatusURL is the path of this job on the API host, e.g. /public/v1/enrichment/jobs/{jobID}.

succeeded
integer
total
integer
updatedAt
string
webhookURL
string