Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
leads
/
{lead_id}
/
pause
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads/456/pause?api_key=YOUR_KEY"

{
  "ok": true,
  "data": "success"
}
Pausing a lead stops all scheduled emails. The lead status changes to PAUSED and any drafted emails are marked as STOPPED.

​
Path Parameters

​
campaign_id
number
required
The campaign ID containing the lead
​
lead_id
number
required
The lead ID to pause

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads/456/pause?api_key=YOUR_KEY"

​
Response Codes

​
200
Success
Lead paused successfully
​
401
Unauthorized
Invalid or missing API key
​
404
Not Found
Campaign not found or you don’t have access to it
​
500
Internal Server Error
Server error occurred
{
  "ok": true,
  "data": "success"
}

​
Behavior Notes

When a lead is paused:
  • Lead status changes to PAUSED
  • The next_timestamp_to_reach is cleared
  • All drafted emails for this lead are marked as STOPPED
  • No new emails will be scheduled until the lead is resumed