Delete list

Deletes an list / address book by id


This operation is used to delete an list / address book in your account when it is no longer required and executes asynchronously so although the request is acknowledged immediately with a '204 No Content'. it will take some time to complete.

❗️

It can't be used to the 'Test' list, as this a special reserved list for the account.

🚧

Do not use this call to remove all contacts from a list!

This call is designed to remove a list when you have finished with it; to remove all contacts from a list you must use the Delete all contacts from list call, and wait for it to complete using the Get bulk contact deletion progress call before importing more contacts.

Path Params
int32
required

The ID of the list / address book

Headers
string
/^(?:\{{0,1}(?:[0-9a-fA-F]){8}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){4}-(?:[0-9a-fA-F]){12}\}{0,1})$/

If you are a partner of Dotdigital and have a verified integration then include your integration tracking token here.

Response

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json