curl -X DELETE "https://server.smartlead.ai/api/v1/campaigns/123/leads/456?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
campaign_id = 123
lead_id = 456
response = requests.delete(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}",
params={"api_key": API_KEY}
)
result = response.json()
if result.get('ok'):
print(f"Lead {lead_id} deleted from campaign {campaign_id}")
const API_KEY = 'YOUR_API_KEY';
const campaignId = 123;
const leadId = 456;
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}?api_key=${API_KEY}`,
{ method: 'DELETE' }
);
const result = await response.json();
if (result.ok) {
console.log(`Lead ${leadId} deleted from campaign ${campaignId}`);
}
{
"ok": true,
"message": "success"
}
{
"message": "Invalid API Key"
}
{
"error": "Campaign not found - Invalid campaign_id."
}
Lead Management
Delete Lead from Campaign
Remove a lead from a campaign and optionally from your account if not used elsewhere
DELETE
/
api
/
v1
/
campaigns
/
{campaign_id}
/
leads
/
{lead_id}
curl -X DELETE "https://server.smartlead.ai/api/v1/campaigns/123/leads/456?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
campaign_id = 123
lead_id = 456
response = requests.delete(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}",
params={"api_key": API_KEY}
)
result = response.json()
if result.get('ok'):
print(f"Lead {lead_id} deleted from campaign {campaign_id}")
const API_KEY = 'YOUR_API_KEY';
const campaignId = 123;
const leadId = 456;
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}?api_key=${API_KEY}`,
{ method: 'DELETE' }
);
const result = await response.json();
if (result.ok) {
console.log(`Lead ${leadId} deleted from campaign ${campaignId}`);
}
{
"ok": true,
"message": "success"
}
{
"message": "Invalid API Key"
}
{
"error": "Campaign not found - Invalid campaign_id."
}
If the lead is not associated with any other campaign, it will be permanently deleted from your account. This action cannot be undone.
Path Parameters
number
required
The campaign ID to remove the lead from
number
required
The lead ID to delete
Query Parameters
string
required
Your SmartLead API key
curl -X DELETE "https://server.smartlead.ai/api/v1/campaigns/123/leads/456?api_key=YOUR_KEY"
import requests
API_KEY = "YOUR_API_KEY"
campaign_id = 123
lead_id = 456
response = requests.delete(
f"https://server.smartlead.ai/api/v1/campaigns/{campaign_id}/leads/{lead_id}",
params={"api_key": API_KEY}
)
result = response.json()
if result.get('ok'):
print(f"Lead {lead_id} deleted from campaign {campaign_id}")
const API_KEY = 'YOUR_API_KEY';
const campaignId = 123;
const leadId = 456;
const response = await fetch(
`https://server.smartlead.ai/api/v1/campaigns/${campaignId}/leads/${leadId}?api_key=${API_KEY}`,
{ method: 'DELETE' }
);
const result = await response.json();
if (result.ok) {
console.log(`Lead ${leadId} deleted from campaign ${campaignId}`);
}
Response Codes
Success
Lead deleted successfully from campaign
Unauthorized
Invalid or missing API key
Not Found
Campaign not found or you don’t have access to it
Internal Server Error
Server error occurred
{
"ok": true,
"message": "success"
}
{
"message": "Invalid API Key"
}
{
"error": "Campaign not found - Invalid campaign_id."
}
Behavior Notes
The lead will only be permanently deleted from your account if it’s not associated with any other campaigns. If the lead exists in other campaigns, only the campaign association is removed.
