ARarkhq-io
Emails

Send raw MIME email

Changed on

Send a pre-formatted RFC 2822 MIME message. Use this for advanced use cases or when migrating from systems that generate raw email content.

Important: The rawMessage field must be base64-encoded. Your raw MIME message (with headers like From, To, Subject, Content-Type, followed by a blank line and the body) must be encoded to base64 before sending.

post/emails/raw

Request

Request body

fromstring required

Sender email address. Must be from a verified domain.

Supported formats:

  • Email only: hello@yourdomain.com
  • With display name: Acme <hello@yourdomain.com>
  • With quoted name: "Acme Support" <support@yourdomain.com>

The domain portion must match a verified sending domain in your account.

tostring[] required

Recipient email addresses

rawMessagestring required

Base64-encoded RFC 2822 MIME message.

You must base64-encode your raw email before sending. The raw email should include headers (From, To, Subject, Content-Type, etc.) followed by a blank line and the message body.

bounceboolean nullable

Whether this is a bounce message (accepts null)

Example request

{
  "from": "Acme <hello@acme.com>",
  "to": [
    "user@example.com"
  ]
}

Response

Email accepted

successtrue required

Example response

{
  "data": {
    "id": "aBc123XyZ456",
    "messageId": "<abc123@mail.arkhq.io>"
  },
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}

Changes

  • e38e03901debRevision changes
    • warning

      the optional response header X-RateLimit-Limit removed for the status 429

    • warning

      the optional response header X-RateLimit-Remaining removed for the status 429

    • warning

      the optional response header X-RateLimit-Reset removed for the status 429

  • 37bce0c9a4d7Revision changes
    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • warning

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

    • info

      removed the postal_error enum value from the / response property for the response status

    • info

      removed the postal_error enum value from the / response property for the response status

    • info

      removed the postal_error enum value from the / response property for the response status

    • info

      removed the postal_error enum value from the / response property for the response status

    • info

      removed the postal_error enum value from the / response property for the response status

    • info

      removed the postal_error enum value from the / response property for the response status