GuidesRecipesAPI ReferenceChangelog
API Reference
Select productLog inHelp centre

Delete all contacts from list

post
https://{region}-api.dotdigital.com/v2/address-books//contacts/delete-all

Deletes all contacts from a given list / address book


This operation can be used to delete all contacts from a given list / address book in your account.

📘

Contacts are deleted from the selected list only. They are not removed from your account. To delete contacts from your account, use Delete multiple contacts.

The result returned will be a 202 Accepted message.

The ID returned in the response can be used to check the status of your request by calling Get bulk contact deletion progress

🚧

Only can be used with custom lists / address books!

It can't be used to delete contacts in All Contacts or Test lists.

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

Updated about 1 month ago

Did this page help you?
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

Updated about 1 month ago

Did this page help you?