Delete a contact

Search Documentation

Search across all developer documentation

contacts

Delete a contact

DELETE /v1/contacts/{email}
Auth required api.contacts.manage

Archives the contact in SES (removes from the contact list). The call is idempotent: deleting a contact that does not exist or is already archived returns 204 with no error.

Supports the Idempotency-Key header.

Path parameters

email string<email> required

Recipient address. Percent-encode @ as %40. Matched case-insensitively.

Responses

204 Contact deleted (or was already absent)
401 Missing, malformed, or unknown API key application/problem+json
403 Key lacks the required scope or plan limit violated application/problem+json
429 Per-org rate limit exceeded application/problem+json
500 Unexpected server-side failure. The code is internal_error. The request_id field can be quoted to SendOps support to investigate. application/problem+json