Skip to Content
SendlySendly
API ReferenceContacts

Permanently erase up to 1000 contacts and their history, and block their addresses from being mailed again (GDPR erasure)

POST
/api/contacts/bulk-purge

Permanently erase up to 1000 contacts and their history, and block their addresses from being mailed again (GDPR erasure). Runs in the background. This cannot be undone.

Requires the contacts:write scope — Create, update, and delete your contacts.

headerAuthorizationBearer <API Key>

API key authentication. Use a sk_* (FULL) or pk_* (SENDING_ONLY) key as the bearer token. Public keys (pk_*) are restricted to the email-send endpoints and the self-serve list subscribe/unsubscribe pair; every other endpoint — event tracking included — answers 403 for them. In scope terms (used by /api/v1/* operations): FULL keys hold every scope; SENDING_ONLY keys hold only emails:send.

Response Body

Accepted

application/json
  1. response

The purge was accepted and is queued.

success*true
Value intrue
data*
Example Request
curl -X POST 'https://api.sendly.now/api/contacts/bulk-purge'
Example Response
{  "success": true,  "data": {    "message": "string"  }}