Skip to main content
DELETE
/
campaigns
/
{campaignId}
/
leads
/
{leadId}
Delete or Unsubscribe Lead
curl --request DELETE \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/leads/{leadId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "firstName": "John",
  "lastName": "Doe",
  "companyName": "Acme Inc",
  "jobTitle": "Growth Engineer",
  "companyDomain": "example.com",
  "email": "support@lemlist.com",
  "preferredContactMethod": "email",
  "industry": "Technology",
  "Company name": "John Doe",
  "_id": "lea_fiDpiGV585wy3Oii2",
  "isPaused": false,
  "campaignId": "cam_bSn8EORHQxbWPjHvu",
  "contactId": "ctc_xW8Ou6C03Csv8vatp",
  "emailStatus": "deliverable"
}

Documentation Index

Fetch the complete documentation index at: https://developer.lemlist.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint uses the Lead object. Make sure to also check the Contact object to understand the distinction between the two.
This endpoint deletes a lead from a campaign. You need to specify action=remove in the params to delete a lead. If you don’t specify action=remove, the endpoint fallbacks to unsubscribing the lead and to do so you need to provide the lead email.

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

Query Parameters

​
action
string

Use 'remove' to force delete. Otherwise it will just unsubscribe the lead from the campaign.

Response

Success

​
firstName
string
​
lastName
string
​
companyName
string
​
jobTitle
string
​
companyDomain
string
​
email
string<email>
​
preferredContactMethod
string
​
industry
string
​
Company name
string
​
_id
string
​
isPaused
boolean
​
campaignId
string
​
contactId
string
​
emailStatus
string
​
{key}
string