---
title: "Unsubscribe"
method: DELETE
path: "/api/v1/subscribers/{email}"
tags: ["Subscribers"]
---

# Unsubscribe

`DELETE /api/v1/subscribers/{email}`

## Request

- Base URL: `https://mailcheer.com`
- URL: `https://mailcheer.com/api/v1/subscribers/{email}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Permission required: `subscribers:write`.

**Does not erase the record**: the person moves to `unsubscribed` and their address enters the suppression list. Erasing the trace would bring the address back at the next file import. The person no longer receives your campaigns, your automations, or sends carrying `unsubscribe_url`; your individual emails still reach them.

## Path parameters

- `email` string, email, required

## Response `200`

Unsubscribed.

- object
  - `object` 'subscriber'
  - `email` string
  - `status` 'unsubscribed'
  - `suppressed` boolean
  - `deleted` false: Always `false`: the record is kept.

## Other responses

- `401`: Key missing, unknown or revoked.
- `403`: The key does not have the requested permission, or the workspace cannot send: `sending_blocked` (suspended, blocked or banned — nothing goes out, through any channel), `commitment_required` (the anti-spam commitment is not accepted), `reputation_blocked` (too many bounces or complaints).
- `404`: The object does not exist in this workspace.

---

[API](https://skmtc.dev/mailcheer/apis/mailcheer-api.md) · [All operations](https://skmtc.dev/mailcheer/apis/mailcheer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailcheer/apis/mailcheer-api/revisions/ba64b7ef2170?raw)