---
search:
  tags:
    - Inboxes
    - POST
seo:
  description: >-
    A standalone draft, or with thread_id and reply_to_email_id a reply draft…
    Reference for the POST /inboxes/{inbox_id}/drafts endpoint in the
    BillionSend API.
sidebar:
  label: Create a draft
  badge: POST
title: Create a draft
type: openapi-operation
---
A standalone draft, or with `thread_id` and `reply_to_email_id` a reply draft in that thread. One unsent reply draft per email: creating another answers 200 with the existing one. A reply draft copies no recipients; set `to` before sending. `attachments` are kept encrypted with the draft until it is sent, rejected, expired or deleted. Nothing is sent until POST /inboxes/&#123;inbox_id&#125;/drafts/&#123;draft_id&#125;/send, or until `send_at` (BillionSend extension) when it is given: the draft is then sent as the caller at that time, through every rule and limit, and must have a recipient. With `send_at`, a reply draft for an email that already has one answers 409 instead of the existing draft.

`POST /inboxes/{inbox_id}/drafts`

**Request body** (`application/json`)

- `to` (string | string[] | null) — An address or a list of them; "Name \<address\>" works too
- `cc` (string | string[] | null) — An address or a list of them; "Name \<address\>" works too
- `bcc` (string | string[] | null) — An address or a list of them; "Name \<address\>" works too
- `subject` (string | null)
- `html` (string | null)
- `text` (string | null)
- `attachments` (object[] | null) — Files with base64 \`content\` (no remote paths), 10 MiB decoded in all; none on the shared domain. A held send keeps them with its draft
- `send_at` (string | null) — BillionSend extension: send the draft at this time, as the caller, within 30 days: an ISO 8601 datetime with offset (e.g. "2026-09-01T12:00:00Z") or a relative time like "in 2 hours". A past time sends it within a minute; null cancels. The send runs every rule and limit then; a refused one leaves the draft unsent with send\_error set and fires inbox.draft.send\_failed. A draft waiting for approval cannot be scheduled (409)
- `thread_id` (string<uuid>) — With reply\_to\_email\_id: a reply draft in this thread
- `reply_to_email_id` (string<uuid>) — The email of the thread the draft answers

Request body example:

```json
{
  "to": "string",
  "cc": "string",
  "bcc": "string",
  "subject": "string",
  "html": "string",
  "text": "string",
  "attachments": [
    {
      "filename": "string",
      "content": "string",
      "content_type": "string",
      "content_id": "string",
      "path": "string"
    }
  ],
  "send_at": "string",
  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",
  "reply_to_email_id": "5e00f13a-4994-422b-8a76-6ae8ac072852"
}
```

**Responses**

- `200` — The existing reply draft
- `201` — Created
- `401` — Missing, malformed, unknown or revoked API key
- `403` — Restricted API key, the inbox's or the shared domain's rules, or held mail
- `404` — Not found
- `409` — Idempotency conflict, or a draft already sent
- `422` — Validation error
- `429` — The inbox's daily send limit, or the team's daily limit for mail from the shared domain, or the rate limit (rate\_limit\_exceeded, with Retry-After)

Response example, 200:

```json
{
  "object": "inbox_draft",
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "type": "standalone",
  "to": [
    "string"
  ],
  "cc": [
    "string"
  ],
  "bcc": [
    "string"
  ],
  "subject": "string",
  "html": "string",
  "text": "string",
  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",
  "reply_to_email_id": "5e00f13a-4994-422b-8a76-6ae8ac072852",
  "email_id": "8e6bf5ae-e456-4654-87f8-33e2156caffc",
  "created_at": "string",
  "updated_at": "string",
  "attachments": [
    {
      "id": "string",
      "filename": "string",
      "content_type": "string",
      "size": 0
    }
  ],
  "status": "draft",
  "approval_reasons": [
    "string"
  ],
  "forward": true,
  "decided_by": "string",
  "decided_at": "string",
  "expires_at": "string",
  "send_at": "string",
  "send_error": "string"
}
```
