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

# Subscription

`POST /subscription`

## Request

- Base URL: `https://stardrift.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://stardrift.ai/subscription`
- Auth: none declared

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/stardrift-api.md) - [All operations](https://skmtc.dev/stardrift/apis/stardrift-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stardrift/apis/stardrift-api/revisions/be9ed1e6c38a?raw)