---
search:
  tags:
    - Inboxes
    - POST
seo:
  description: >-
    Forwards the email from the inbox… Reference for the POST
    /inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/forward endpoint
    in the BillionSend API.
sidebar:
  label: Forward a thread email
  badge: POST
title: Forward a thread email
type: openapi-operation
---
Forwards the email from the inbox address, quoted under "---------- Forwarded message ---------" with its From, Date, Subject and To, after an optional note. Its attachments go along, with any `attachments` you add, within 10 MiB in all. An email that carries malware is never forwarded. Accepts an `Idempotency-Key`; a forward the inbox's rules hold answers 202 with the Draft.

`POST /inboxes/{inbox_id}/threads/{thread_id}/emails/{email_id}/forward`

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

- `to` (string | string[], required) — An address or a list of them; "Name \<address\>" works too
- `cc` (string | string[]) — An address or a list of them; "Name \<address\>" works too
- `bcc` (string | string[]) — An address or a list of them; "Name \<address\>" works too
- `html` (string) — HTML body
- `text` (string) — Plain-text body
- `subject` (string) — 1-2000 characters on one line; defaults to the thread subject with Re: or Fwd:
- `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
- `requires_approval` (boolean) — BillionSend extension: hold the email as a draft that a person approves (202 with the Draft)
- `headers` (any) — Not supported: only an empty value is accepted, anything else answers 422

Request body example:

```json
{
  "to": "string",
  "cc": "string",
  "bcc": "string",
  "html": "string",
  "text": "string",
  "subject": "string",
  "attachments": [
    {
      "filename": "string",
      "content": "string",
      "content_type": "string",
      "content_id": "string",
      "path": "string"
    }
  ],
  "requires_approval": true,
  "headers": null
}
```

**Responses**

- `200` — Sent
- `202` — Held for approval
- `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
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84"
}
```
