Emails

Forward an email

Forward an email to recipients you choose. It is sent from the mailbox that owns the thread, with the original quoted below your note; all recipients are blocklist-checked.

Requires one of the following scopes: emails:send, emails:all, all:all.

post/v1/emails/{id}/forward

Request

Base URL: https://api.mailbeast.ai
URL: https://api.mailbeast.ai/v1/emails/{id}/forward
Auth: HTTP bearer

Path parameters

idstring uuid required

Headers

Idempotency-Keystring

Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Optional. A unique key you generate (max 255 chars, such as a UUID) that makes this request safe to retry. Retrying with the same key replays the original response instead of repeating the operation. Reusing a key with a different body returns 422.

Request body

tostring[] required

ccstring[]

bccstring[]

subjectstring

Overrides the default Fwd: subject.

Example request

{
  "to": [
    "colleague@acme.com"
  ],
  "body": {
    "html": "<p>Thanks, that works for me.</p>",
    "text": "Thanks, that works for me."
  },
  "cc": [
    "cto@acme.com"
  ],
  "bcc": [
    "crm@acme.com"
  ],
  "subject": "Fwd: Pricing question"
}

Response

idstring required

The email that was queued for sending.

threadIdstring nullable required

statusstring required

The email is queued for delivery. Poll the email to see it sent.

Example response

{
  "id": "5e9a3c81-7d24-4b60-9f13-8a6c2e0d4b57",
  "threadId": "13a265fd-f0f2-b1d1-d6fc-154e483183e7",
  "status": "queued"
}

Changes

No recorded changes to this operation across all 1 revision of this API.