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.