Bulk delete contacts
contacts:write scope (or a broader one that includes it).
Use this endpoint when you need to remove several contacts in a single call. Contacts are processed independently: the response maps each contact id that could not be deleted to the reason it was skipped.
Authorizations
Authenticate every request with a Bearer token. Pass your Reply API key in the
Authorization header:
Get your API key from the Reply dashboard: Settings → API Key.
Body
List of contact IDs to delete
Response
Non-atomic result. The response body is a dictionary keyed by contact id listing per-item failures. Empty object {} means all contacts were deleted successfully.
Per-item failures use the ContactError enum. Common per-item slugs:
Dictionary of per-item failures keyed by contact id. Empty object {} means all succeeded.
Per-item error for non-atomic bulk operations. Only failed items are returned in the response dictionary. Items not present in the dictionary succeeded.