Skip to main content
Resend Docs

Search documentation

Type to search this documentation.

On this pageOverview

Forward Thread Email

POST

/

inboxes

/

:inbox_id

/

threads

/

:thread_id

/

emails

/

:email_id

/

forward

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.threads.emails.forward({
  inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
  threadId: '4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12',
  emailId: '5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60',
  to: ['colleague@example.org'],
  text: 'Flagging this refund request for you.',
});
cURL
curl -X POST 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/threads/4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12/emails/5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60/forward' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "to": ["colleague@example.org"],
  "text": "Flagging this refund request for you."
}'
CLI
resend inboxes threads emails forward \
  --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1 \
  --thread_id 4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12 \
  --email_id 5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60 \
  --to colleague@example.org \
  --text "Flagging this refund request for you."
Response
{
  "id": "6a0c8e58-3d9e-4f7a-8b14-2e3f4a5b6c71",
  "email_id": "6a0c8e58-3d9e-4f7a-8b14-2e3f4a5b6c71",
  "direction": "outbound",
  "from": "support@example.com",
  "to": ["colleague@example.org"],
  "cc": [],
  "bcc": [],
  "reply_to": [],
  "subject": "Fwd: Refund for order 1041",
  "message_id": null,
  "html": "<div>Flagging this refund request for you.<br>\n<br>\n---------- Forwarded message ---------<br>\nFrom: Ada Lovelace &lt;ada@example.org&gt;<br>\nDate: Wed, Aug 5, 2026 at 2:03 PM<br>\nSubject: Refund for order 1041<br>\nTo: support@example.com<br>\n<br>\nCould I get a refund for order 1041?</div>",
  "text": "Flagging this refund request for you.\n\n---------- Forwarded message ---------\nFrom: Ada Lovelace <ada@example.org>\nDate: Wed, Aug 5, 2026 at 2:03 PM\nSubject: Refund for order 1041\nTo: support@example.com\n\nCould I get a refund for order 1041?",
  "attachments": [],
  "read": true,
  "received_at": "2026-08-05T14:12:04.110Z"
}

Forwards from the inbox address. to is required. The original message is quoted under a forwarded-message banner.

string | string[]

required

Recipient email address. For multiple addresses, send as an array of strings. Max 50.

string

An HTML note sent above the quoted original.

string

A plain-text note sent above the quoted original.

string

The subject of the forward. When omitted, the thread subject is used, prefixed with Fwd: if it isn’t already.

string

The ID of the queued outbound email.

string

The ID of the queued outbound email. Same value as id.

string

Always outbound.

string

Sender email address.

string[]

The recipients of the message.

string[]

The CC recipients of the message.

string[]

The BCC recipients of the message.

string[]

Always an empty array.

string

The subject of the sent forward.

string | null

Always null.

string

The HTML body, including the note and the quoted original.

string

The plain-text body, including the note and the quoted original.

array

The attachments on the message.

Hide properties

string

The ID of the attachment.

string | null

The filename of the attachment.

number | null

The size of the attachment in bytes.

boolean

Whether the message has been read.

string

ISO 8601 timestamp when the message was sent.

Node.js
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.inboxes.threads.emails.forward({
  inboxId: 'b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1',
  threadId: '4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12',
  emailId: '5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60',
  to: ['colleague@example.org'],
  text: 'Flagging this refund request for you.',
});
cURL
curl -X POST 'https://api.resend.com/inboxes/b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1/threads/4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12/emails/5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60/forward' \
     -H 'Authorization: Bearer re_xxxxxxxxx' \
     -H 'Content-Type: application/json' \
     -d $'{
  "to": ["colleague@example.org"],
  "text": "Flagging this refund request for you."
}'
CLI
resend inboxes threads emails forward \
  --inbox_id b3e2b2b6-3f0e-4c8e-9ad3-2f43a1e2c7f1 \
  --thread_id 4d8e2a1c-9b3f-4c6d-8a21-3e5f7c9c0d12 \
  --email_id 5b1a9f47-2c8d-4e6f-9a03-1d2e3f4a5b60 \
  --to colleague@example.org \
  --text "Flagging this refund request for you."
JSON
{
  "id": "6a0c8e58-3d9e-4f7a-8b14-2e3f4a5b6c71",
  "email_id": "6a0c8e58-3d9e-4f7a-8b14-2e3f4a5b6c71",
  "direction": "outbound",
  "from": "support@example.com",
  "to": ["colleague@example.org"],
  "cc": [],
  "bcc": [],
  "reply_to": [],
  "subject": "Fwd: Refund for order 1041",
  "message_id": null,
  "html": "<div>Flagging this refund request for you.<br>\n<br>\n---------- Forwarded message ---------<br>\nFrom: Ada Lovelace &lt;ada@example.org&gt;<br>\nDate: Wed, Aug 5, 2026 at 2:03 PM<br>\nSubject: Refund for order 1041<br>\nTo: support@example.com<br>\n<br>\nCould I get a refund for order 1041?</div>",
  "text": "Flagging this refund request for you.\n\n---------- Forwarded message ---------\nFrom: Ada Lovelace <ada@example.org>\nDate: Wed, Aug 5, 2026 at 2:03 PM\nSubject: Refund for order 1041\nTo: support@example.com\n\nCould I get a refund for order 1041?",
  "attachments": [],
  "read": true,
  "received_at": "2026-08-05T14:12:04.110Z"
}

Was this page helpful?

⌘I

Suggest an edit

Propose a replacement for this page. The site team reviews it before applying any changes.

Export
Documentation menu