---
title: "Create Draft"
method: POST
path: "/api/v1/mail/mailboxes/{email_address}/drafts"
tags: ["Drafts"]
---

# Create Draft

`POST /api/v1/mail/mailboxes/{email_address}/drafts`

## Path parameters

- `email_address` string, required

## Headers

- `Idempotency-Key` string, nullable

## Request body

- DraftCreate
  - `recipients` DraftRecipients
    - `to` string[], nullable
    - `cc` string[], nullable
    - `bcc` string[], nullable
  - `subject` string, nullable
  - `body_text` string, nullable
  - `body_html` string, nullable
  - `reply_to` string, email, nullable
  - `thread_id` string, uuid, nullable
  - `in_reply_to_message_id` string, nullable
  - `references` string[], nullable
  - `attachments` AttachmentUpload[], nullable
    - `filename` string, required
    - `content_type` string, required — MIME type, e.g. image/jpeg
    - `content_base64` string, required — Base64-encoded file content
    - `content_id` string, nullable — Mark this part as an inline image referenced from body_html as cid:<content_id> (e.g. <img src="cid:chart1">). Surrounding angle brackets are optional. Omit for a normal attachment.
  - `track_opens` boolean
  - `forward_message_id` string, uuid, nullable
  - `forward_mode` 'inline' | 'wrapped'
  - `include_original_attachments` boolean
  - `forward_note_text` string, nullable
  - `forward_note_html` string, nullable

## Response `201`

Successful Response

- DraftDetailResponse
  - `id` string, uuid, required
  - `mailbox_id` string, uuid, required
  - `from_address` string, required
  - `to_addresses` string[]
  - `cc_addresses` string[]
  - `bcc_addresses` string[]
  - `subject` string, nullable
  - `snippet` string, nullable
  - `has_attachments` boolean
  - `attachment_count` integer
  - `generation` integer, required
  - `send_state` 'draft' | 'sending' | 'uncertain', required
  - `track_opens` boolean
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `body_text` string, nullable
  - `body_html` string, nullable
  - `reply_to` string, nullable
  - `thread_id` string, uuid, nullable
  - `message_id` string, nullable
  - `in_reply_to` string, nullable
  - `references` string[]
  - `forward_source_message_id` string, uuid, nullable
  - `forward_note_text` string, nullable
  - `forward_note_html` string, nullable
  - `attachment_metadata` DraftAttachmentResponse[]
    - `part_index` integer, required
    - `filename` string, required
    - `content_type` string, required
    - `size` integer, required
    - `content_id` string, nullable
    - `is_inline` boolean

## Other responses

- `422` — Validation Error
- `4XX` — Client error with Support Agent information.
- `5XX` — Server error with Support Agent information.

---

[API](https://skmtc.dev/inkbox/apis/inkbox-api.md) · [All operations](https://skmtc.dev/inkbox/apis/inkbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inkbox/inkbox-api/revisions/31f357e7e6f8/schema)