MepMail Docs
API referenceEndpointsContactsBatchRemove

Delete contacts in bulk

POST
/contacts/batch/remove

MepMail extension (Resend deletes contacts one at a time): deletes up to 1000 contacts by id or by email address in one request and lists the rows actually deleted; unknown ids or addresses are skipped. Emails stay in the log; erase: true also scrubs each address from email history, event payloads and API logs, like DELETE /contacts/{id}?erase=true.

AuthorizationBearer <token>

An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/contacts/batch/remove" \  -H "Content-Type: application/json" \  -d '{    "emails": [      "old@example.com"    ]  }'
{  "data": [    {      "object": "contact",      "contact": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",      "deleted": true    }  ]}