FLOW - How to bulk delete contacts

Create a bulk delete data flow

Go to Workflows > Data flow. You can also access it from Admin console > Workflows > Data flows

  • Create a new data flow with following source and destination
  1. Source: CSV Upload
  2. Destination: Delete contact

Create a new data flow interface.

Once created, you will need to add the following in JSONATA expression if your key identifier is phonenumber:

{
 "identifierKey": "phonenumber",
 "identifierValue": "+" & $.Phone
}

If your key identifier is emailaddress:

{
 "identifierKey": "emailaddress",
 "identifierValue": $.Email
}

If you want to delete contacts irrespective of the identifier you can use below format. In this case, ID is the name of the column of csv file you upload.

{
 "contactId": $.ID
}

Data synchronization interface.

Upload file to delete

Now, you can export contacts from a list or segment or the contacts page, and upload here in the data flow.

  • Click on Save and then click on Run Now
  • You can Edit data flow to upload more files and then again click on Save > Run Now.

Dropdown menu with various options.

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Get startedRead docsor

Using Claude Code, Cursor, or Codex? Point it at our MCP server — tools for every channel we expose, with scoped agent keys.

Cursor