v49

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-02-185890337.1 KB

Emails

Send raw MIME email

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 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"
  }
}