---
title: "Create a draft. Requires message_send or draft_write. draft_write does not send mail. in_reply_to or forward_of derives threading from that message. send_at schedules it and adds the scheduled label. Idempotency-Key and client_id replay the original draft."
method: POST
path: "/api/v1/inboxes/{id}/drafts"
tags: ["Drafts"]
---

# Create a draft. Requires message_send or draft_write. draft_write does not send mail. in_reply_to or forward_of derives threading from that message. send_at schedules it and adds the scheduled label. Idempotency-Key and client_id replay the original draft.

`POST /api/v1/inboxes/{id}/drafts`

## Request

- Base URL: `https://cooperemail.com`
- URL: `https://cooperemail.com/api/v1/inboxes/{id}/drafts`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string

## Request body

- DraftWrite
  - `to` string[]
  - `cc` string[]
  - `bcc` string[]
  - `reply_to` string
  - `subject` string
  - `text` string
  - `html` string
  - `in_reply_to` string: Reply to this message. Mutually exclusive with forward_of.
  - `forward_of` string: Forward this message. Mutually exclusive with in_reply_to.
  - `reply_all` boolean
  - `send_at` string, date-time, nullable
  - `client_id` string

## Response `201`

Created draft

- Draft
  - `object` 'draft'
  - `id` string
  - `inbox_id` string
  - `to` string[]
  - `cc` string[]
  - `bcc` string[]
  - `reply_to` string, nullable
  - `subject` string
  - `text` string
  - `html` string, nullable
  - `preview` string
  - `labels` string[]
  - `in_reply_to` string, nullable
  - `forward_of` string, nullable
  - `reply_all` boolean
  - `send_status` 'scheduled' | 'sending' | 'failed' | 'null', nullable
  - `send_at` string, date-time, nullable
  - `approval_status` 'pending' | 'approved' | 'rejected' | 'null', nullable
  - `client_id` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

---

[API](https://skmtc.dev/cooperemail/apis/cooper-email-api.md) · [All operations](https://skmtc.dev/cooperemail/apis/cooper-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cooperemail/apis/cooper-email-api/revisions/6d800a7b3e33?raw)