Delete contacts in bulk
Deletes up to 200 addresses in one call, each the way `DELETE /contacts/{email}` deletes one: a saved contact goes with its notes, photo and audience memberships, and every address is hidden, so a send does not record it again.
Runs the real call against your workspace, with your own key.
POST /contacts/batch-delete
Deletes up to 200 addresses in one call, each the way DELETE /contacts/{email} deletes one: a saved contact goes with its notes, photo and audience memberships, and every address is hidden, so a send does not record it again.
Example
Needs contacts:write.
curl -X POST "$OE/contacts/batch-delete" -H "$AUTH" -H 'content-type: application/json' -d '{ "emails": ["[email protected]", "[email protected]", "not-an-address"]}'{ "object": "contact_batch_delete", "deleted": 2, "saved": 1, "invalid": ["not-an-address"]}deleted counts the addresses deleted and hidden, saved or only seen in mail, and saved how many of them were saved contacts. An entry that is not an address comes back in invalid and the rest still go through.
A repeated address counts once, and sending the same call again changes nothing. There is no undo.