> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Forward Conversation Message

> Email a copy of one message to another address

Email a copy of one received (`inbound`) or sent (`outbound`) message to another address, such as a teammate. Stored attachments are included up to 15 MB in total; files that are not stored, cannot be read, or do not fit are left out and listed in the forwarded email. Notes and system messages cannot be forwarded.

The forward is recorded in the conversation as a `system` message ("Forwarded to …") whose `deliveryStatus` moves from `pending` to `sent`, or to `failed` if it cannot be sent. It does not change the conversation's status, unread state or last activity, and the recipient's replies are not tracked in the conversation. Each request sends a new forward, so retrying a successful request sends another copy. A forward counts toward your sending usage and triggers the `email.sent` webhook, like other sent email. Replies from the recipient are not added to the conversation.

Requires the `conversations:write` scope.

## Request

<ParamField path="conversationId" type="string" required>
  Conversation ID.
</ParamField>

<ParamField path="messageId" type="string" required>
  ID of the message to forward, from [Get Conversation](./get).
</ParamField>

<ParamField body="to" type="string" required>
  One email address to forward the message to.
</ParamField>

<ParamField body="senderProfileId" type="string">
  Sender profile to forward from. Its sending domain must be verified. When
  omitted, the company default sender is used. List profiles with [List Sender
  Profiles](../sender-profiles/list).
</ParamField>

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/conversations/conv_abc123/messages/msg_abc123/forward" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"to": "sales@example.com"}'
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "forward": {
      "id": "msg_fwd123",
      "conversationId": "conv_abc123",
      "messageId": "msg_abc123",
      "to": "sales@example.com",
      "deliveryStatus": "pending",
      "createdAt": "2026-09-30T10:00:00.000Z"
    }
  }
  ```

  ```json 400 (invalid recipient) theme={null}
  {
    "error": "Provide one valid email address to forward to.",
    "code": "invalid_recipient"
  }
  ```

  ```json 400 (note) theme={null}
  {
    "error": "Only received and sent emails can be forwarded; notes stay internal.",
    "code": "message_not_forwardable"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 404 theme={null}
  {
    "error": "Message not found in this conversation",
    "code": "message_not_found"
  }
  ```
</ResponseExample>
