---
title: "Subscription"
method: POST
path: "/subscription"
---

# Subscription

`POST /subscription`

Manage email-subscription state for a recipient via an HMAC token.

Actions:
- `unsubscribe` (default) — opt out of one topic. Falls back to the
  legacy drip-campaign token path if HMAC verify fails so that emails
  sent before STA-266 keep working.
- `subscribe` — opt back in to one topic.
- `unsubscribe_all` — global opt-out (`flow_name='*'`) suppressing every
  non-transactional send for this recipient.

No auth: recipients of invite reminders may not even have accounts.

## Request body

- SubscriptionRequest
  - `token` string, required
  - `action` 'unsubscribe' | 'subscribe' | 'unsubscribe_all'

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/stardrift/apis/fastapi.md) · [All operations](https://skmtc.dev/stardrift/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stardrift/fastapi/revisions/00746572572a/schema)