Delete a lead

DELETE/api/v1/leads/{id}scope: leads.delete

Permanently delete a lead. The underlying contact record is preserved (a contact may be linked to multiple leads, clients, or other records). Returns 204 No Content on success.

Path parameters

Field	Type	Required	Description
id	string	yes	Lead id

Response

Returns a single object with this shape:

(none)

Example response

null

cURL

curl -X DELETE 'https://your-host/api/v1/leads/:id' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Try it

DELETE/api/v1/leads/{id}

The playground sends real requests against your org. Sign in to spin up a 1-hour test token. You need DEVELOPER permission and the DEVELOPER_API feature enabled in the org.

Path

id*

Lead id