---
title: "Delete a contact list"
method: DELETE
path: "/v1/contact-lists/{contact_list_id}"
---

# Delete a contact list

`DELETE /v1/contact-lists/{contact_list_id}`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/contact-lists/{contact_list_id}`
- Auth: none declared

Refused (409, reason contact_list_in_use) while a campaign using the list is launching, scheduled, running or paused; the response names up to five of those campaigns (id, name, status) with total and has_more. Cancel them, or wait until they finish, then delete. Nothing is detached from a campaign. Otherwise the list is deleted: it no longer appears in any list, search, import, export, edit or new campaign, and a draft campaign that named it must pick another list before it can launch. Contacts no campaign run has taken are removed. Contacts a campaign run has taken are kept only as that campaign's records, so its contacts, results export and reviews read as before; they are no longer found as contacts. The response counts both: removed_contacts and kept_for_campaign_history.

## Path parameters

- `contact_list_id` string, required

## Response `200`

{id, deleted, removed_contacts, kept_for_campaign_history}

## Other responses

- `404`: No such list in this workspace
- `409`: A campaign that can still dial the list uses it: {reason, message, campaigns: [{id, name, status}], total, has_more}

---

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