Forward a message

Forward an inbound message to new recipients. The subject is prefixed with Fwd: (unless it already starts with one). The original message is always carried along: its rendered body is quoted below your optional note and its attachments are re-attached (any attachments you supply are added on top).

A forward has no implicit recipient — you must address it with to (and optionally cc/bcc). The from rules match those of the Reply operation: rejected for Mailtrap-hosted inboxes, required-and-domain-bound for custom-domain inboxes.

post

Authorizations

Api-TokenstringRequired

API token in Api-Token header

Path parameters

inbox_idintegerRequired

Inbound inbox ID

Example: 1

idstringRequired

Inbound message ID

Example: 1700000000000123

Body

Options for the sent message. All fields are optional. reply and reply_all must carry a body (text and/or html); forward may omit it, since the original message is quoted automatically. forward also requires at least one recipient in to. Addresses use the Email Sending API { email, name } shape.

textstringOptional

Plain-text body.

Example: Thanks for reaching out. We are looking into it.

htmlstringOptional

HTML body.

Example: <p>Thanks for reaching out. We are looking into it.</p>

categorystring · max: 255Optional

Email API category for the sent message.

Example: Support reply

Responses

201

Message queued for delivery. Returns the UUID(s) the Email API assigned to the sent message, one per recipient.

application/json

message_idsstring[]Required

UUIDs assigned by the Email API to the sent message, one per recipient. These are the sent message's UUIDs — not the inbound message ID acted on, nor an RFC Message-ID header value.

Example: ["1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"]

400

The message could not be sent. Returned for an invalid sender (for example a from on a Mailtrap-hosted inbox, or one outside the inbox's domain) and for validation errors rejected by the Email API.

application/json

401

Unauthorized

application/json

403

The caller lacks permission on the inbox, or the inbox's monthly sending limit has been reached.

application/json

404

Not found

application/json

413

The message exceeds the maximum allowed size.

application/json

429

Too many requests. Retry after a short delay.

application/json

post/api/inbound/inboxes/{inbox_id}/messages/{id}/forward

curl -X POST https://mailtrap.io/api/inbound/inboxes/{inbox_id}/messages/{id}/forward \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{ "to": [{ "email": "[e-mail]" }], "text": "Please take a look at the message below." }'

{
  "message_ids": [
    "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d"
  ]
}