Inbound emails

Forward with attachments

Changed on

Forwards the message (with its attachments) to to, plus optional cc / bcc (max 50 each, like POST /emails). Sent through the normal send pipeline under the calling API key, so suppressed recipients are dropped and the same 403/422/429 conditions apply. Needs mailboxes:manage as well as email:send, since it reads the inbound message and its attachments.

post/inbound/{id}/forward

Request

Path parameters

idinteger required

Inbound email numeric id.

Request body

fromstring required
tostring[] required
ccstring[]
bccstring[]
messagestring

Response

Queued.

idstring required

Public email id (em_…). Every email endpoint is addressed by this id.

replayedboolean

Present and true when idempotency_key (or the Idempotency-Key header) matched an earlier send: id is that email and nothing was sent. The response also carries X-Idempotent-Replay: true.

test_modetrue

Present only when authenticated with an sk_test_ key: the email was recorded and marked delivered but never handed to a mail server.

spam_scorenumber

rspamd score of the rendered message (omitted when the spam check was skipped).

Example response

{
  "id": "em_8c1f3a2b9d4e5f60718293a4"
}

Changes

    • warning

      the / request property's maxLength was set to 320

    • warning

      the / request property's maxLength was set to 320

    • warning

      the request property's maxLength was set to 998

    • warning

      the / request property's maxLength was set to 320

    • warning

      added the new daily_limit_exceeded enum value to the //// response property for the response status

    • warning

      added the new daily_limit_exceeded enum value to the response property for the response status

    • warning

      added the new daily_limit_exceeded enum value to the response property for the response status

    • warning

      added the new daily_limit_exceeded enum value to the response property for the response status

    • warning

      added the new daily_limit_exceeded enum value to the response property for the response status

    • warning

      added the new daily_limit_exceeded enum value to the response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the //// response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the response property for the response status

    • warning

      added the new monthly_limit_exceeded enum value to the response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the //// response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the response property for the response status

    • warning

      added the new send_limit_exceeded enum value to the response property for the response status

    • info

      added the new optional request property

    • info

      added the new optional request property