---
title: "Unsubscribe subscriber"
method: POST
path: "/v4/subscribers/{id}/unsubscribe"
tags: ["Subscribers"]
---

# Unsubscribe subscriber

`POST /v4/subscribers/{id}/unsubscribe`

Unsubscribes the subscriber from all future emails, moving them to the `cancelled` state. Returns `204 No Content` on success. The subscriber record, history, and tags are retained — they are not deleted from the account.

**Note:** this is the API equivalent of the subscriber clicking unsubscribe. Treat it as consent-revoking and effectively permanent — only re-subscribe someone with their explicit permission.

## Path parameters

- `id` integer, required

## Request body

- object

## Response `204`

Unsubscribes the subscriber

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated
- `404` — Returns a 404 when the provided id does not exist

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)