Skip to main content
POST
Inboxes are currently in private beta and only available to a limited number of users. The response shape might change before GA.Get early access if you’re interested in testing this feature.Once you have access, upgrade your Resend SDK to use the new methods:
Forwards from the inbox address. to is required. The original message is quoted under a forwarded-message banner, and its attachments are included. Files in attachments are sent along with those. Both count toward the 25MB of content. An original attachment that was sent as a URL cannot be forwarded. The forward carries the same In-Reply-To and References headers as a reply to the original message, so mail clients may group it with the original conversation. These headers can’t be set or overridden.

Path Parameters

Body Parameters

string | string[]
required
Recipient email address. For multiple addresses, send as an array of strings. to, cc, and bcc combined cannot exceed 50 recipients.
string | string[]
CC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit with to.
string | string[]
BCC recipient email address. For multiple addresses, send as an array of strings. Counts toward the 50-recipient limit with to.
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. Max 2000 characters.
array
Filename and content of attachments (max 25MB of content per message). A path is fetched when the email is sent and does not count toward that limit.See examples
object
Custom headers to add to the email. In-Reply-To, References, and Reply-To can’t be set and return 422.

Headers

string
Add an idempotency key to prevent duplicated emails.
  • Should be unique per API request
  • Idempotency keys expire after 24 hours
  • Have a maximum length of 256 characters
Learn more

Response Fields

string
The ID of the queued outbound email.