---
title: "Subscribe an email to a list (TinysendKit, double opt-in)"
method: POST
path: "/sdk/subscribe"
tags: ["SDK"]
---

# Subscribe an email to a list (TinysendKit, double opt-in)

`POST /sdk/subscribe`

## Request

- Base URL: `https://api.tinysend.com/v1`
- URL: `https://api.tinysend.com/v1/sdk/subscribe`
- Auth: HTTP bearer

## Request body

- object
  - `list` string, required: List subdomain to subscribe to
  - `email` string, email, required
  - `appName` string
  - `bundleId` string
  - `appVersion` string
  - `os` string
  - `osVersion` string

## Response `200`

pending = confirmation email sent, token = the handle GET /sdk/subscribe/status answers for; already_subscribed = active subscriber exists (no token: that device never proved the inbox)

- object
  - `status` 'pending' | 'already_subscribed', required
  - `token` string

## Other responses

- `401`: Unauthorized
- `404`: List not found
- `422`: Unsupported list type
- `429`: Rate limited

---

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