Delete leads

Delete multiple leads at once. Use with caution - this action is permanent.

Leads can be selected either by an explicit list of IDs (data.attributes.lead_ids) or by a filter. When filter is omitted or sent as an empty object, the request applies to every accessible lead and must include confirm_delete_all: true; otherwise the API rejects the request with error_code: filterless_bulk_delete_requires_confirmation.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Delete leads

boolean

Required and must be true when filter is omitted or empty. When missing or false in a filterless request, the API returns 400 with error_code: filterless_bulk_delete_requires_confirmation. Ignored when filter contains at least one criterion.

data
object

Used for deletion by explicit lead IDs.

filter
object

Filter criteria identifying which leads to delete. An empty object applies to every accessible lead and requires confirm_delete_all to be true.

Responses

204

Leads deleted successfully. No content returned.

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json