---
title: "Create a draft"
method: POST
path: "/v1/inboxes/{inboxId}/drafts"
tags: ["Inboxes"]
---

# Create a draft

`POST /v1/inboxes/{inboxId}/drafts`

## Request

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

Prepare a message without sending it — e.g. an agent's reply for a human to approve. Pass `replyToEmailId` to make it a reply; the reply headers and recipient are worked out when it's sent. Nothing is validated as sendable until then.

## Path parameters

- `inboxId` string, required

## Request body

- object
  - `replyToEmailId` string
  - `to` string, email
  - `subject` string
  - `text` string
  - `html` string
  - `cc` string[]
  - `bcc` string[]
  - `attachments` object[]
  - `sendAt` string, date-time

## Response `201`

Created.

- InboxDraft
  - `draftId` string, required
  - `inboxId` string, required
  - `replyToEmailId` string, nullable
  - `threadId` string, nullable
  - `to` string, nullable
  - `cc` string[]
  - `bcc` string[]
  - `subject` string, nullable
  - `text` string, nullable
  - `html` string, nullable
  - `attachments` object[]
    - `filename` string
    - `contentType` string
  - `sendAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `401`: Missing or invalid API key.
- `404`: Not found.
- `422`: Request validation failed (code `validation_error`, 422).

---

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