v2

latestOpenAPI 3.1.0MIT2026-07-26105151330.5 KB
Contacts

Batch Delete Contacts

Delete up to 1000 contacts by email in a single request. Requires API key with audience:write. Partial-success-safe: emails with no matching contact are returned in notFound, never treated as errors.

post/v1/contacts/bulk-delete

Headers

Idempotency-Keystring

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Request body

emailsstring[] required

Email addresses to delete (1-1000 per request).

projectIdstring required

Response

Batch delete result

successboolean required
errorstring nullable