Skip to main content
PATCH
/
campaigns
/
{campaignId}
/
leads
/
{leadId}
Update Lead in a Campaign
curl --request PATCH \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/leads/{leadId} \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '{
  "preferredContactMethod": "email"
}'
{
  "campaignId": "cam_9NsHPnykWESTncCW8",
  "campaignName": "NEW TO DELETE",
  "leadUrl": "https://api.lemlist.com/api/leads/bvelitchkine%40gmail.com",
  "firstName": "Bastien",
  "lastName": "Velitchkine",
  "companyName": "Bastien VELITCHKINE EI",
  "jobTitle": "Growth Engineer",
  "companyDomain": "bvelitchkine.com",
  "email": "support@lemlist.com",
  "preferredContactMethod": "email",
  "_id": "lea_mizMsAEkRrJuhouYe",
  "isPaused": false,
  "contactId": "ctc_Rofmb6uNGyaPNZ2ni",
  "emailStatus": "deliverable"
}
This endpoint uses the Lead object.
This endpoint updates an existing lead’s information 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

leadId
string
required

The unique identifier of the lead

Body

application/json
firstName
string
lastName
string
companyName
string
jobTitle
string
preferredContactMethod
string

Preferred contact method (email, linkedIn)

Response

Success

campaignId
string
campaignName
string
leadUrl
string

URL to access the lead

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

Whether the lead is paused in the campaign

contactId
string

Associated contact ID

emailStatus
string

Email verification status