Skip to main content
POST
/
api
/
v1
/
campaigns
/
{campaign_id}
/
leads
/
{lead_id}
/
category
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads/789/category?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id": 1, "pause_lead": false}'

{
  "success": true,
  "message": "Lead category updated"
}
Categorize leads (Interested, Not Interested, etc.) for better organization and reporting.

​
Path Parameters

​
campaign_id
number
required
Campaign ID
​
lead_id
number
required
Lead ID

​
Query Parameters

​
api_key
string
required
Your SmartLead API key

​
Request Body

​
category_id
number
Category ID to assign (use null to remove category)
​
pause_lead
boolean
default:"false"
Pause the lead after categorizing
curl -X POST "https://server.smartlead.ai/api/v1/campaigns/123/leads/789/category?api_key=YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category_id": 1, "pause_lead": false}'

​
Response Example

{
  "success": true,
  "message": "Lead category updated"
}