Skip to main content
POST
/
campaigns
/
{campaignId}
/
leads
/
{email}
Create Lead in Campaign
curl --request POST \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/leads/{email} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "firstName": "John",
  "lastName": "Doe",
  "companyName": "lemlist",
  "jobTitle": "Developer",
  "linkedinUrl": "https://www.linkedin.com/in/johndoe",
  "phone": "+33 123456789"
}'
{
  "campaignId": "cam_9NsHPnykWESTncCW8",
  "campaignName": "NEW TO DELETE",
  "firstName": "Bastien",
  "lastName": "Velitchkine",
  "companyName": "lemlist",
  "jobTitle": "GTM Engineer",
  "companyDomain": "bvelitchkine.com",
  "email": "support@lemlist.com",
  "_id": "lea_mizMsAEkRrJuhouYe",
  "isPaused": false,
  "contactId": "ctc_Rofmb6uNGyaPNZ2ni"
}
This endpoint uses the Lead object.
This endpoint creates a new lead in a specific campaign.

Authorizations

Authorization
string
header
required

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

Path Parameters

campaignId
string
required

The unique identifier of the campaign

email
string<email>
required

The email address of the lead

Query Parameters

deduplicate
boolean

Search email address in other campaigns. Will not insert the lead if email address already exists. Default: false

linkedinEnrichment
boolean

Run the LinkedIn enrichment. Default: false

findEmail
boolean

Find verified email. Default: false

verifyEmail
boolean

Verify existing email (debounce). Default: false

findPhone
boolean

Find phone number. Default: false

Body

application/json
firstName
string

First name of the lead

lastName
string

Last name of the lead

companyName
string

Company name

jobTitle
string

Job title

linkedinUrl
string

LinkedIn profile URL

picture
string

Profile picture URL

phone
string

Phone number

companyDomain
string

Company domain

icebreaker
string

Personalized icebreaker message

contactOwner
string

Contact owner ID

Response

Success

campaignId
string
campaignName
string
email
string<email>
firstName
string
lastName
string
companyName
string
jobTitle
string
companyDomain
string
_id
string
isPaused
boolean

Whether the lead is paused in the campaign

contactId
string

Associated contact ID