Delete leads

Delete leads from a campaign

Delete one or more leads from a campaign. Only pending leads (not yet sent) can be deleted.

Important Notes

• Only leads with PENDING status can be deleted
• Leads that have already received emails cannot be deleted
• This action cannot be undone

Example Usage

import requests

campaign_id = "550e8400-e29b-41d4-a716-446655440000"
lead_ids = [
    "650e8400-e29b-41d4-a716-446655440000",
    "750e8400-e29b-41d4-a716-446655440000"
]

response = requests.delete(
    f"https://api.coldsend.io/api/public/v1/campaigns/{campaign_id}/leads",
    headers={"X-API-Key": "your-api-key"},
    json={"lead_ids": lead_ids}
)

print(response.json())