Skip to main content
POST
/
emails
cURL
curl -X POST https://api.arkhq.io/v1/emails \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": ["[email protected]"],
    "subject": "Hello World",
    "html": "<h1>Welcome!</h1>"
  }'
{
  "success": true,
  "data": {
    "id": "msg_abc123def456",
    "messageId": "<[email protected]>",
    "to": [
      "[email protected]"
    ],
    "status": "pending"
  },
  "meta": {
    "requestId": "req_xyz789"
  }
}

Authorizations

​
Authorization
string
header
required

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

Authorization: Bearer YOUR_API_KEY

Headers

​
Idempotency-Key
string

Unique key for idempotent requests. If a request with this key was already processed, the cached response is returned. Keys expire after 24 hours.

Maximum string length: 255

Body

application/json

Email message to send.

Size limits:

  • Total message size (including attachments): 14MB maximum
  • HTML body: 5MB maximum
  • Plain text body: 5MB maximum
  • Individual attachment: 10MB maximum
​
from
string
required

Sender email address. Must be from a verified domain.

Supported formats:

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

Minimum string length: 1
Example:

"Acme <[email protected]>"

​
to
string<email>[]
required

Recipient email addresses (max 50)

Required array length: 1 - 50 elements
Example:
["[email protected]"]
​
subject
string
required

Email subject line

Required string length: 1 - 998
​
cc
string<email>[] | null

CC recipients (accepts null)

Maximum array length: 50
​
bcc
string<email>[] | null

BCC recipients (accepts null)

Maximum array length: 50
​
replyTo
string<email> | null

Reply-to address (accepts null)

​
html
string | null

HTML body content (accepts null). Maximum 5MB (5,242,880 characters). Combined with attachments, the total message must not exceed 14MB.

Maximum string length: 5242880
​
text
string | null

Plain text body (accepts null, auto-generated from HTML if not provided). Maximum 5MB (5,242,880 characters).

Maximum string length: 5242880
​
tag
string | null

Tag for categorization and filtering (accepts null)

Maximum string length: 1000
​
headers
object

Custom email headers (accepts null)

​
attachments
object[] | null

File attachments (accepts null)

Response

Email accepted successfully

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