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}'
import requests
API_KEY = "YOUR_API_KEY"
def update_lead_category(campaign_id, lead_id, category_id, pause=False):
payload = {
"category_id": category_id,
"pause_lead": pause
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/category",
params={"api_key": API_KEY},
json=payload
)
if response.status_code == 200:
print(f"✅ Lead categorized as {category_id}")
return response.json()
# Mark as interested and pause
update_lead_category(123, 789, category_id=1, pause=True)
const API_KEY = 'YOUR_API_KEY';
async function updateCategory(campaignId, leadId, categoryId, pause = false) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}/category?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ category_id: categoryId, pause_lead: pause })
}
);
return response.json();
}
await updateCategory(123, 789, 1, true);
{
"success": true,
"message": "Lead category updated"
}
Campaign Leads
Update Lead Category in Campaign
Assign or change the category for a lead within a campaign
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}'
import requests
API_KEY = "YOUR_API_KEY"
def update_lead_category(campaign_id, lead_id, category_id, pause=False):
payload = {
"category_id": category_id,
"pause_lead": pause
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/category",
params={"api_key": API_KEY},
json=payload
)
if response.status_code == 200:
print(f"✅ Lead categorized as {category_id}")
return response.json()
# Mark as interested and pause
update_lead_category(123, 789, category_id=1, pause=True)
const API_KEY = 'YOUR_API_KEY';
async function updateCategory(campaignId, leadId, categoryId, pause = false) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}/category?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ category_id: categoryId, pause_lead: pause })
}
);
return response.json();
}
await updateCategory(123, 789, 1, true);
{
"success": true,
"message": "Lead category updated"
}
Categorize leads (Interested, Not Interested, etc.) for better organization and reporting.
Path Parameters
number
required
Campaign ID
number
required
Lead ID
Query Parameters
string
required
Your SmartLead API key
Request Body
number
Category ID to assign (use
null to remove category)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}'
import requests
API_KEY = "YOUR_API_KEY"
def update_lead_category(campaign_id, lead_id, category_id, pause=False):
payload = {
"category_id": category_id,
"pause_lead": pause
}
response = requests.post(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}/category",
params={"api_key": API_KEY},
json=payload
)
if response.status_code == 200:
print(f"✅ Lead categorized as {category_id}")
return response.json()
# Mark as interested and pause
update_lead_category(123, 789, category_id=1, pause=True)
const API_KEY = 'YOUR_API_KEY';
async function updateCategory(campaignId, leadId, categoryId, pause = false) {
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}/category?api_key=${API_KEY}`,
{
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ category_id: categoryId, pause_lead: pause })
}
);
return response.json();
}
await updateCategory(123, 789, 1, true);
Response Example
{
"success": true,
"message": "Lead category updated"
}
Related Endpoints
⌘I
