Skip to main content
POST
/
emails
/
raw
Send raw MIME email
curl --request POST \
  --url https://api.arkhq.io/v1/emails/raw \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "from": "Acme <hello@acme.com>",
  "to": [
    "user@example.com"
  ],
  "rawMessage": "<string>",
  "tenantId": "cm6abc123def456",
  "bounce": true
}
'
{
  "success": true,
  "data": {
    "id": "aBc123XyZ456",
    "tenantId": "cm6abc123def456",
    "to": [
      "jsmith@example.com"
    ],
    "status": "pending",
    "messageId": "<abc123@mail.arkhq.io>",
    "sandbox": true
  },
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}

Authorizations

​
Authorization
string
header
required

Use your API key from arkhq.io/org/credentials

Authorization: Bearer YOUR_API_KEY

Body

application/json
​
from
string
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.

Minimum string length: 1
Example:

"Acme <hello@acme.com>"

​
to
string<email>[]
required

Recipient email addresses

Minimum array length: 1
Example:
["user@example.com"]
​
rawMessage
string
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.

Minimum string length: 1
​
tenantId
string | null

The tenant ID to send this email from. Determines which tenant's configuration (domains, webhooks, tracking) is used.

  • If your API key is scoped to a specific tenant, this must match that tenant or be omitted.
  • If your API key is org-level, specify the tenant to send from.
  • If omitted, the organization's default tenant is used.
Example:

"cm6abc123def456"

​
bounce
boolean | null

Whether this is a bounce message (accepts null)

Response

Email accepted

​
success
boolean
required
​
data
object
required
​
meta
object
required