---
title: "Delete a prospect list"
method: DELETE
path: "/lists/{id}"
tags: ["Prospects"]
---

# Delete a prospect list

`DELETE /lists/{id}`

## Request

- Base URL: `https://warmysender.com/api/v1`
- URL: `https://warmysender.com/api/v1/lists/{id}`
- Auth: HTTP bearer

Deletes one of your lists, exactly like deleting it in the app. Prospects that are in this list and in no other list are permanently deleted with it, together with their campaign history. Prospects that are also in another list are kept. If any prospect that would be deleted is still active in a campaign, nothing is deleted and the response names the campaigns to pause first.

Required scope: `prospects:write`.

`contacts_deleted` is how many prospects were deleted with the list — the ones that were in no other list. It can be 0.

Deleted prospects lose their campaign history, so if you add the same people again later, the "Recently contacted" setting on your campaigns will not know they were already emailed. To keep someone, add them to another list before deleting this one.

Deleting a list also unlinks it from any LinkedIn campaign it was attached to.

Calling it again for a list that is already gone returns 404.

To stop new verification runs from creating lists in the first place, pass `create_list: false` to POST /verification/batches.

## Path parameters

- `id` string, required

## Response `200`

Success

## Other responses

- `401`: `unauthorized` — Missing or invalid API key.
- `403`: `insufficient_scope` — The API key lacks the scope this endpoint requires.
- `404`: `not_found` — No list with that id in this workspace.
- `409`: `list_in_use` — Some prospects that would be deleted with the list are still active in a campaign. Nothing was deleted. `details.campaigns` lists the campaigns, `details.blocked_contacts` how many prospects, and `details.action` what to do.
- `429`: `rate_limited` — Too many requests — slow down and retry after the Retry-After delay.

---

[API](https://skmtc.dev/warmysender/apis/warmysender-public-api.md) · [All operations](https://skmtc.dev/warmysender/apis/warmysender-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/warmysender/apis/warmysender-public-api/revisions/eb5c7f10a1cd?raw)