DELETE/campaigns/:id/leads/:leadId

Permanent single-lead delete. Blocked while the campaign is still finding leads, and blocked for a lead that was emailed or is queued to send. Decrements campaign totalLeads. Credits are not refunded.

0 credits. Rate class: campaign_control (default 20/min).

Request

DELETE /campaigns/camp_abc/leads/lead_1
X-API-Key: sk_live_...

Response

{ "id": "lead_1", "campaignId": "camp_abc", "deleted": true }

Errors

not_found · conflict (ingestion in progress, or outreach-locked lead) · rate_limited · upstream_unavailable

MCP

Tool: delete_lead. Confirm first. Prefer batch-delete for bulk.