---
title: "Forward Email"
method: POST
path: "/v2/emails/{email_id}/forward"
tags: ["emails"]
---

# Forward Email

`POST /v2/emails/{email_id}/forward`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/emails/{email_id}/forward`
- Auth: HTTP bearer

Create a DRAFT forward of an existing email. Does not send.

The forwarded draft renders the source email Gmail-style and re-attaches its
attachments. Recipient lists come exclusively from the request body — the
source email's recipients are never used.

## Path parameters

- `email_id` string, required

## Request body

- ForwardEmailRequest: Request to forward an existing email — creates a DRAFT, does not send.
  - `to` string[]: Recipient addresses.
  - `cc` string[]
  - `bcc` string[]
  - `note` string, nullable: Optional prefatory note rendered above the forwarded chain.
  - `subject` string, nullable: Override subject. Defaults to source subject prefixed with `Fwd: `.
  - `email_sender_id` string, nullable: Optional outgoing sender. When omitted, picks the source's shared inbox if applicable, else the user's default sender. Mirrors reply.

## Response `200`

Successful Response

- EmailSummary: Email summary for inbox list rows.
  - `created_at` string, date-time, required
  - `modified_at` string, date-time, nullable, required
  - `id` string, required
  - `subject` string, nullable, required
  - `snippet` string, nullable, required
  - `from` string, nullable, required
  - `to` string[], required
  - `cc` string[], required: List of CC email addresses
  - `direction` 'inbound' | 'outbound', required
  - `status` 'draft' | 'pending' | 'sending' | 'sent' | 'error', required
  - `sent_at` string, date-time, nullable, required: When the email was sent.
  - `is_unread` boolean, required
  - `author_id` string, nullable, required
  - `author_name` string, nullable, required
  - `processing_status` 'processing' | 'completed' | 'failed', required
  - `object` string, required: String representing the object's type. Objects of the same type share the same value.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/stuut/apis/stuut-api.md) - [All operations](https://skmtc.dev/stuut/apis/stuut-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stuut/apis/stuut-api/revisions/3b5ab941f918?raw)