---
title: "One-click unsubscribe"
method: POST
path: "/v1/subscriber-lists/{id}/{email}/unsubscribe"
tags: ["Subscriptions"]
---

# One-click unsubscribe

`POST /v1/subscriber-lists/{id}/{email}/unsubscribe`

## Request

- Base URL: `https://api.bluefox.email`
- URL: `https://api.bluefox.email/v1/subscriber-lists/{id}/{email}/unsubscribe`
- Auth: HTTP bearer

Legacy flat URL shape. Not API-key authenticated - requires a signed one-click-unsubscribe token (the ?token= query param from a dispatched email's List-Unsubscribe link).

## Path parameters

- `id` string, required
- `email` string, required

## Query parameters

- `token` string, required

## Response `200`

OK

## Other responses

- `403`: Missing or invalid API key
- `404`: Subscriber not found

---

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