Skip to main content
Talk to salesStart

Delete lead

Permanently delete a lead by ID.

DELETE/api/leads/{lead_id}
HTTP referenceScope authenticated user sessionUpdated April 25, 2026

This page documents the canonical HTTP contract for this endpoint.

This route requires an authenticated user session; developer API keys are blocked. Before deleting the Lead record it stops pending outreach and preserves associated audit history. This response excerpt is abbreviated because the returned cleanup result can add effect counts. If cleanup succeeds but record deletion does not, the route returns 409.

Path parameters

  • lead_idrequired

    string

    Lead ID.

Errors

StatusMeaning
401Missing or invalid user session.
403Developer API keys are blocked for this session-only route.
404Lead not found.
409Outreach was stopped but the Lead record was not deleted.

Docs