Skip to main content

Delete contacts in bulk

DELETE 
/v2/contacts/bulk/:lookupKey

Removes every contact named in the body, each read with the :lookupKey from the URL.

Each key is deleted exactly as the single delete would delete it, and every deleted contact emits its own event. Login accounts are not touched.

A key that cannot be deleted does not fail the request: it lands in failedIds with an entry in failures saying why, and the rest of the batch is deleted regardless. Repeated keys are collapsed, so a key sent twice gets one verdict.

Request​

Responses​

Bulk delete completed. Read failures for the keys that were not deleted.