Delete a list

DEL/lists/{listId}

Deletes a list as the app does: its leads stay in your leads, a draft campaign that used it needs another list, and a running campaign keeps the people already in it. A list still importing can’t be deleted yet.

Try itSend a real request with your API key

Path

listIdstringRequired
The list.

Headers

Idempotency-Keystring
Any unique value up to 255 characters, like a UUID. The request runs once; repeats within 24 hours get the first answer, with Idempotent-Replayed: true. Up to 255 characters.

Answer

200 OK Deleted.

dataDeletedRequired
Inside it
- idstringRequired
- deletedbooleanRequired

Errors

401 Unauthorizedunauthorized
404 Not foundnot_found not_in_campaign
409 Conflictconflict idempotency_in_progress workspace_busy campaign_finished campaign_without_list tag_limit lead_has_history campaign_not_launched campaign_cannot_resume ambiguous_email
422 Can’t processidempotency_key_reused
429 Too many requestsrate_limited
500 Server errorserver_error

Every error has the same shape. See Errors.

DELETE /lists/{listId}

curl -X DELETE "https://app.salesteam.dev/api/v1/lists/LIST_ID" \
  -H "Authorization: Bearer $SALESTEAM_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

const response = await fetch("https://app.salesteam.dev/api/v1/lists/LIST_ID", {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${process.env.SALESTEAM_API_KEY}`,
    "Idempotency-Key": crypto.randomUUID(),
  },
});
console.log(response.status, await response.json());

import os, uuid
import requests

response = requests.delete(
    "https://app.salesteam.dev/api/v1/lists/LIST_ID",
    headers={"Authorization": f"Bearer {os.environ['SALESTEAM_API_KEY']}", "Idempotency-Key": str(uuid.uuid4())},
)
print(response.status_code, response.json())

200 answer

{
  "data": {
    "id": "list_5a1b",
    "deleted": true
  }
}