Skip to main content
DELETE
/
api
/
v1
/
contact-lists
/
{id}
Delete List
curl --request DELETE \
  --url https://api.example.com/api/v1/contact-lists/{id}

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

Delete a contact list and all its contacts.
This action is irreversible. All contacts in the list will be permanently deleted.

​
Path Parameters

​
id
string
required
The unique list ID (e.g., lst_abc123).

​
Examples

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });

await mailbreeze.lists.delete("lst_abc123");

console.log("List deleted");

​
Response

Returns 204 No Content on success with no response body.

​
Errors

CodeHTTP StatusDescription
NOT_FOUND404List with this ID doesn’t exist
LIST_IN_USE409List is being used by active campaigns
If you need to preserve contacts, export them before deleting the list, or move them to another list using the contacts update endpoint.