On this page
DELETE/campaigns/:campaignId/leads/:leadId
Credits: 0 (no refund)
Rate limit: 10 / minute (shared with batch-delete)
Purpose
Permanently delete one lead. Irreversible — insert credits are not refunded.
Missing lead → 404 (not an idempotent 200). Campaign still importing / extending → 409.
Prefer POST …/leads/batch-delete when removing many leads.
Request
DELETE /campaigns/:campaignId/leads/:leadId
X-API-Key: sk_live_...
Response 200
{ "id": "lead_xyz", "deleted": true, "creditsRefunded": 0 }
May include "reconciliationFailed": true if campaign totals could not be fully refreshed after the lead was removed (the lead is still gone).
MCP
Tool: delete_lead — destructiveHint: true; confirm with the user first.