Skip to main content
POST
/
leads
/
pause
/
{leadId}
Pause Lead
curl --request POST \
  --url https://api.lemlist.com/api/leads/pause/{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": true,
    "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.
Use the campaignId query parameter to pause the lead in a specific campaign only.

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

​
leadId
string
required

The unique identifier of the lead

Query Parameters

​
campaignId
string

ID of the campaign. If provided, pauses the lead only in that 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