Skip to main content
DELETE
Delete a contact list
Deletes a saved list and its dialing queue. Take the id from Create a contact list or List contact lists.
This cannot be undone. Every contact in the list is deleted with it.

Example

Response (200):

Retrying

A second call with the same ID returns 404. When you retry after a timeout, treat a 404 as already deleted.

Errors

Authorizations

x-api-key
string
header
required

Team-scoped API key generated in the Salesfinity dashboard under Settings → Connections → API & Webhooks. A missing or invalid key returns HTTP 403.

Path Parameters

id
string
required

ID of the saved list, from POST /v1/contact-lists or GET /v1/contact-lists/csv. A value that is not a valid ID fails with 400.

Example:

"6650c1f2a4b8e93d2c1f0a11"

Response

Deleted.

success
boolean

Always true.

Example:

true