API Reference

Forward Received Email

POST /emails/receiving/:id/forward — forward a received email (with its attachments) to another address.

POST/emails/receiving/:id/forward

Forwards a received email to another address through the normal send pipeline. The original subject, body, and attachments are re-sent (inline images keep their content_id so they still render). from must be an address on one of your verified domains — it is validated exactly like POST /emails.

Path parameters
idstringrequired

The id of the received email to forward.

Body parameters
tostring | string[]required

The address(es) to forward to.

fromstringrequired

A verified sending address.

subjectstringoptional

Optional; overrides the original subject.

Request
import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.emails.receiving.forward('4ef9a417-02e9-4d39-ad75-9611e0fcc33c', {
  "to": "teammate@example.com",
  "from": "Acme <hello@yourdomain.com>"
});
console.log({ data, error });

Response

{
  "object": "email",
  "id": "6278820d-2421-42d0-85f0-80e9e28c1c69"
}

The response is the outbound email's id — the forward is sent like any other email and shows up in your sent mail and logs. Attachments whose bytes were not retained (e.g. inbound storage was off when the mail arrived) are skipped rather than failing the forward. Returns not_found (404) if the received email does not exist for your account, and missing_required_field (422) when to or from is omitted. See the error reference.