API ReferenceContacts
Permanently erase up to 1000 contacts and their history, and block their addresses from being mailed again (GDPR erasure)
POST
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.
header
AuthorizationBearer <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.
Accepted
application/json- response
The purge was accepted and is queued.
success*trueValue in
truedata*curl -X POST 'https://api.sendly.now/api/contacts/bulk-purge'Example Response
{ "success": true, "data": { "message": "string" }}