---
title: "Create Draft"
method: POST
path: "/v1/drafts"
tags: ["drafts"]
---

# Create Draft

`POST /v1/drafts`

## Request

- Base URL: `https://www.tandem-cc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tandem-cc.com/v1/drafts`
- Auth: none declared

Create a server-side draft.

Body:
  {
    "from_handle": "brian@tandem-cc.com",     # required
    "to": ["joe@tandem-cc.com"],              # required, >=1 recipient
    "body": "...",                        # required (may be empty string)
    "subject": "...",                     # optional
    "cc": ["..."],                        # optional
    "in_reply_to": "m_...",               # optional; resolves thread_id
    "drafted_by": "claude" | "human"      # optional; default "claude"
  }

Returns the created draft including its draft_id.

## Headers

- `X-Tandem-Api-Key` string, nullable
- `Authorization` string, nullable

## Request body

- object

## Response `201`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tandem-cc/apis/tandem-api.md) · [All operations](https://skmtc.dev/tandem-cc/apis/tandem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tandem-cc/apis/tandem-api/revisions/3b804877b47c?raw)