Skip to main content
POST
Forward email

Authorizations

x-api-key
string
header
required

API key (sk-proj-…) from Settings → API Keys. Required for sold API calls outside the Mermail console.

Path Parameters

mailboxId
string
required

Mailbox public_id (UUID), hosted alias id, or current email

emailId
string
required

Original email id

Body

application/json
to
required

Recipient email or list

Example:
from
required
subject
string
required
Example:

"Hello from Mermail"

cc
bcc
html
string
Example:

"<p>Hi there</p>"

text
string
Example:

"Hi there"

attachments
object[]

Base64 file bytes or an existing attachment_id from the same authorized mailbox. Omit to preserve attachments from source_draft_id (send) or draft_id (save/schedule); [] clears; an array replaces the complete set. Storage limits: 20 files, 10 MiB each, 25 MiB decoded total. Encoded message limits include overhead: about 5 MiB for hosted addresses and about 40 MB for custom-domain addresses. Local paths and URLs are not accepted.

Maximum array length: 20
in_reply_to
string
references
string[]
thread_id
string
source_draft_id
string

Response

Accepted

id
string
status
string
Example:

"sent"