API ReferenceContacts
Delete up to 1000 contacts, by id (contactIds) or by email address (emails)
POST
Delete up to 1000 contacts, by id (contactIds) or by email address (emails). Pass one of the two. By id runs in the background.
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 delete was accepted and is queued.
success*trueValue in
truedata*curl -X POST 'https://api.sendly.now/api/contacts/bulk-delete'Example Response
{ "success": true, "data": { "message": "string" }}