Resend: Inboxes Forward Thread Email

Forward a thread email.

Tool ID: resend_inboxes_forward_thread_email

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'resend_inboxes_forward_thread_email',
  {
    "inbox_id": "inbox_123",
    "thread_id": "123e4567-e89b-42d3-a456-426614174000",
    "email_id": "123e4567-e89b-42d3-a456-426614174000",
    "to": "example"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline run resend_inboxes_forward_thread_email --input '{
  "inbox_id": "inbox_123",
  "thread_id": "123e4567-e89b-42d3-a456-426614174000",
  "email_id": "123e4567-e89b-42d3-a456-426614174000",
  "to": "example"
}'

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000"
  }
}

Use deepline describe resend_inboxes_forward_thread_email --json for the latest machine-readable contract.

Input reference

Forwards a message from the inbox address right away, with no stored draft. The original message is quoted under a forwarded-message banner, below the optional html or text note. The attachments of the original message are sent with the forward, together with any attachments you add. The request returns a 422 when they exceed 25 MB of content in total. An original attachment that was sent from a URL (path) cannot be forwarded, and the request returns a 422. The whole email, encoded, can be at most 40 MB, or the request returns a 422.

Name	Type	Required	Default	Details
`payload.inbox_id`	`string`	Yes	—	The Inbox ID or the inbox email address, such as `support@acme.com`. A value that contains `@` must be a valid email address, and any other value must be a UUID, or the request returns a 422. The address match is case-insensitive and never falls back to the inbox `name`. An address that matches no inbox returns a 404.
`payload.thread_id`	`string`	Yes	—	The Thread ID. Format: `uuid`.
`payload.email_id`	`string`	Yes	—	The Email ID of the message to forward, as returned in `data[].id` by the list thread emails endpoint. Format: `uuid`.
`payload.to`	`string \| array`	Yes	—	Recipient email address. For multiple addresses, send as an array of strings. Must name at least one address. `to`, `cc` and `bcc` combined cannot exceed 50 recipients. Each address is `email@example.com` or `Name` . An address that is not valid returns a 422.
`payload.cc`	`string \| array \| null`	No	—	CC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit. Each address is `email@example.com` or `Name` . An address that is not valid returns a 422.
`payload.bcc`	`string \| array \| null`	No	—	BCC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit. Each address is `email@example.com` or `Name` . An address that is not valid returns a 422.
`payload.html`	`string`	No	—	An HTML note sent above the quoted original.
`payload.text`	`string`	No	—	A plain-text note sent above the quoted original.
`payload.subject`	`string`	No	—	The subject of the forward. Cannot be only whitespace or contain a line break. When omitted, the thread subject is used, prefixed with `Fwd:` if it does not already start with it. Minimum length: 1. Maximum length: 2000.
`payload.attachments`	`array`	No	—	Files to attach, as on `POST /emails`. Each one needs `content` or `path`. They share one limit with the attachments of the original message, which the forward also sends. Together they can have at most 25 MB of `content`. A `path` file does not count toward the 25 MB, because it is fetched when the email is sent. An empty file, a blocked file type, a `path` that does not start with `http` or that starts with `http://localhost:`, or a `content_type` that is not a valid MIME type returns a 422. See the live schema for the complete constraint.
`payload.headers`	`record`	No	—	Custom headers to add to the email. The `In-Reply-To`, `References` and `Reply-To` headers are set by Resend and cannot be set here. Sending one of them, in any letter case, returns a 422. Header names cannot be empty, and names and values cannot contain line breaks or null characters, or the request returns a 422. `null` means no custom headers.
`payload.idempotency_key`	`string`	No	—	Stable send identity for retries. Resend deduplicates for 24 hours. Plays derive a step key when omitted. Minimum length: 1. Maximum length: 256.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.id`	`string`	Yes	—	The ID of the sent email. Use it with the emails endpoints. Format: `uuid`.
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: fixed (per call).
Estimated Deepline credits: 0 per pricing unit.
Provider-native pricing may still exist outside Deepline credit billing.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation