---
title: "Forward an email"
method: POST
path: "/v1/emails/{id}/forward"
tags: ["Emails"]
---

# Forward an email

`POST /v1/emails/{id}/forward`

## Request

- Base URL: `https://api.mailbeast.ai`
- URL: `https://api.mailbeast.ai/v1/emails/{id}/forward`
- Auth: HTTP bearer

Forward an email to recipients you choose. It is sent from the mailbox that owns the thread, with the original quoted below your note; all recipients are blocklist-checked.

Requires one of the following scopes: `emails:send`, `emails:all`, `all:all`.

## Path parameters

- `id` string, uuid, required

## Headers

- `Idempotency-Key` string

## Request body

- ForwardEmailApiDto
  - `to` string[], required
  - `body` EmailBodyInputApiDto
    - `html` string
    - `text` string
  - `cc` string[]
  - `bcc` string[]
  - `subject` string: Overrides the default `Fwd:` subject.

## Response `201`

- SendEmailApiResponseDto
  - `id` string, required: The email that was queued for sending.
  - `threadId` string, nullable, required
  - `status` string, required: The email is queued for delivery. Poll the email to see it sent.

## Other responses

- `400`: The request body or parameters failed validation.
- `401`: Missing or invalid API key.
- `402`: A plan limit was reached - top up or upgrade.
- `403`: The key lacks a required scope, or the plan does not include API access.
- `404`: The resource does not exist in your workspace.
- `409`: The request conflicts with current state - e.g. a request with the same Idempotency-Key is still being processed, or the operation partially applied.
- `422`: The Idempotency-Key was already used with a different request body. Use a new key for a new operation.
- `429`: Rate limit exceeded - retry after the interval in the Retry-After header.
- `503`: A dependency is temporarily unavailable.

---

[API](https://skmtc.dev/mailbeast/apis/mailbeast-public-api.md) · [All operations](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mailbeast/apis/mailbeast-public-api/revisions/6440ce0738a4?raw)