GuidesRecipesAPI ReferenceChangelog
API Reference
Select productLog inHelp centre

Delete contacts from list

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

Deletes multiple contacts from an list / address book


This operation deletes multiple contacts from a specified list / address book. This will run in the background, and for larger address books may take some minutes to fully delete.

The result returned will be a 202 Accepted message. You can use the id returned in the response to check the status of your request by calling Get bulk contact deletion progress

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

🚧

Limitations

The maximum number of contact IDs you can include: 1000.

Path Params
int32
required

The id of the list / address book

Body Params
RAW_BODY
array of int32s
required

The IDs of the contacts that need deleting from the address book

RAW_BODY*
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?