Forward Received Email
POST /emails/receiving/:id/forward — forward a received email (with its attachments) to another address.
/emails/receiving/:id/forwardForwards 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.
idstringrequiredThe id of the received email to forward.
tostring | string[]requiredThe address(es) to forward to.
fromstringrequiredA verified sending address.
subjectstringoptionalOptional; overrides the original subject.
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.