v1
latestOpenAPI 3.0.32026-08-0615026.5 KBLeads
Upsert leads.
This endpoint is used to upsert (update or insert) leads.
The leads are sent in the request body. The leads are an array of objects. The leads.*.values are key/value pairs with the values of the lead.
Required fields for creating or updating a lead
To create a new lead, at least one of:
- linkedin_profile_url
To update an existing lead, at least one of:
- lead_id (GenPage Lead ID)
- genpage_url (GenPage URL)
Optional but strongly recommended fields
- first_name
- company_name
- company_domain
The response is the job ID.
The job ID can be used to get the status of the job, and get all the leads that were upserted by this request.
post/api/external/v1/leads/upsert-leads
Request body
Example request
{
"from": "MyCompanyName",
"campaign_id": 1,
"audience_id": 1,
"callback_url": "http://bailey.com/",
"is_generate_ai_analysis": true,
"leads": [
{
"lead_id": 16,
"genpage_url": "https://myworkspace.genpa.ge/aws-john",
"values": {
"first_name": "John",
"email": "john@aws.com",
"company_name": "Amazon Web Services",
"linkedin_profile_url": "https://www.linkedin.com/in/john-doe-1234567890"
}
}
]
}Response
Example response
{
"job_id": "1234567890"
}