MepMail Docs
API referenceEndpointsContactsId

Delete a contact

DELETE
/contacts/{id}

Deletes the contact and its segment memberships. Its emails stay in the log; pass erase=true to also scrub the address from email history, event payloads and API logs.

AuthorizationBearer <token>

An API key from the dashboard (ms_…), sent as Authorization: Bearer. A sending-only key reaches the /emails routes only.

In: header

Path Parameters

id*string
Length1 <= length

Query Parameters

erase?string

MepMail extension. true also erases the address from email history, event payloads and API logs (a GDPR/LGPD erasure); by default the send log is kept and ages out with the team's retention window

Value in

  • "true"
  • "false"

Response Body

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/contacts/string"
{  "object": "contact",  "contact": "ae2014de-c168-4c61-8267-70d2662a1ce1",  "deleted": true}