---
title: "Delete Leads"
method: PUT
path: "/{sub_domain}/api/leads/mass-delete"
tags: ["Leads"]
---

# Delete Leads

`PUT /{sub_domain}/api/leads/mass-delete`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/leads/mass-delete`
- Auth: API key in header `Authorization`

Delete multiple leads that match a filter.

**When to use.** Remove many leads in one request. To delete a single known lead, use `DELETE /leads/{id}`.

**Request body.** A filter object selecting which leads to delete. Each key is a lead field: a scalar value matches by equality and an array matches any of the listed values. An empty body is rejected with `400`.

**Returns.** `{ "removedLeads": [ ... ] }` listing the leads that were deleted.

**Example.** `PUT /api/leads/mass-delete` with body `{ "id": [ 101, 102 ] }`

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Request body

- LeadMassDeleteInput
  - `id` unknown[], nullable: Lead IDs to delete.
    - unknown
  - `first_name` string[], nullable: Match by first name(s).

## Response `200`

Successful Response

- RemovedLeadsResponse
  - `removedLeads` object[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)