Unsubscribe Email Contact API

Unsubscribe an email contact while preserving engagement history.

Unsubscribe a subscriber by email. This is a soft delete for sending eligibility: contact history, events, and workflow context are preserved.

Request

DELETE /api/v1/email/contacts/:email

curl -X DELETE https://growth.example.com/api/v1/email/contacts/lead%40example.com \
  -H "x-api-key: org_api_key"

Response

{
  "contact": {
    "id": "m57...",
    "email": "[email protected]",
    "status": "unsubscribed",
    "tags": ["newsletter"]
  },
  "unsubscribed": true
}

Error responses:

Status	Meaning
`400`	Invalid email.
`401`	Missing or invalid API key.
`404`	Contact not found.

Notes

The endpoint creates an unsubscribe suppression record.
Bounced or complained contacts are not downgraded, but an unsubscribe suppression is still added.

Update Email Contact API Add Email Contact Tags API