Set up business email,
then keep it working.
One complete manual.

npm install @hihemax/mail

# Either header authenticates the same key. Bearer:
curl https://mail.hihemax.com/api/v1/send \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": "a@example.com", "subject": "Hi", "text": "Hello!"}'

# Or X-API-Key:
curl https://mail.hihemax.com/api/v1/send \
  -H "X-API-Key: hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{"to": "a@example.com", "subject": "Hi", "text": "Hello!"}'

curl -X POST https://mail.hihemax.com/api/v1/send \
  -H "X-API-Key: hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "customer@example.com",
    "subject": "Your receipt",
    "text": "Payment received."
  }'

curl -X POST https://mail.hihemax.com/api/v1/send \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "customer@example.com",
    "templateId": "YOUR_ACTIVE_TEMPLATE_ID",
    "variables": { "first_name": "Ada", "order_id": "HM-1042" }
  }'

curl -X POST https://mail.hihemax.com/api/v1/send \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "ada@example.com",
    "subject": "Your order receipt",
    "text": "Thanks for your order!",
    "fromName": "Acme Receipts",
    "fromAccount": "hello@acme.com"
  }'

{
  "success": true,
  "id": "<message-id>",
  "to": ["customer@example.com"],
  "from": "hello@acme.com",
  "creditsRemaining": 97,
  "requestId": "req_abc123"
}

curl -X POST https://mail.hihemax.com/api/v1/send/batch \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      { "to": "a@example.com", "subject": "Receipt", "text": "Thanks" },
      { "to": "b@example.com", "subject": "Receipt", "text": "Thanks" }
    ]
  }'

curl https://mail.hihemax.com/api/v1/email-accounts \
  -H "Authorization: Bearer hm_your_key"

{
  "accounts": [
    {
      "id": "mailbox_abc123",
      "emailAddress": "hello@acme.com",
      "displayName": "Acme Support",
      "domainId": "dom_xyz",
      "domainName": "acme.com",
      "domainVerified": true,
      "active": true,
      "usable": true,
      "storageQuota": 10737418240,
      "storageUsed": 24117248,
      "forwardingAddress": null,
      "logoId": null,
      "createdAt": "2026-06-10T08:00:00.000Z"
    }
  ],
  "requestId": "req_01"
}

# 1. Provision the tenant subdomain (auto-verified: you own brnd.ng)
curl -X POST https://mail.hihemax.com/api/v1/domains \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "alice.brnd.ng" }'

# 2. Create a mailbox under it (free; plan mailbox cap applies)
curl -X POST https://mail.hihemax.com/api/v1/email-accounts \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "alice.brnd.ng",
    "localPart": "info",
    "password": "use-a-strong-password",
    "displayName": "Alice Shop"
  }'

# One-time DNS at the brnd.ng registrar (covers every subdomain)
*.brnd.ng.            MX   10 mail.hdock.app.
*.brnd.ng.            TXT  "v=spf1 include:hdock.app ~all"
_brnd DMARC stays on the parent: _dmarc.brnd.ng. TXT "v=DMARC1; p=none"

# Per claimed subdomain, publish the DKIM record from POST /domains
<selector>._domainkey.alice.brnd.ng.  TXT  "v=DKIM1; k=rsa; p=<public-key>"

curl -X POST https://mail.hihemax.com/api/v1/verify/start \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "type": "otp",
    "codeLength": 6,
    "expiresIn": 900,
    "brandName": "Acme"
  }'

curl -X POST https://mail.hihemax.com/api/v1/verify/check \
  -H "Authorization: Bearer hm_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "verificationId": "ver_abc", "code": "123456" }'

curl https://mail.hihemax.com/api/v1/me \
  -H "Authorization: Bearer hm_your_key"

{
  "success": true,
  "key": { "id": "key_abc", "label": "production" },
  "credits": { "balance": 97, "currency": "USD" },
  "usage": { "recentCount": 3, "recentCost": 3 },
  "requestId": "req_abc123"
}

curl "https://mail.hihemax.com/api/v1/usage?limit=50" \
  -H "Authorization: Bearer hm_your_key"

{
  "success": false,
  "error": {
    "type": "insufficient_credits",
    "code": "insufficient_credits",
    "message": "Insufficient credits"
  },
  "requestId": "req_xyz"
}

import { HihemaxMail } from '@hihemax/mail'

const mail = new HihemaxMail(process.env.HIHEMAX_API_KEY!)

// List the mailboxes your workspace owns
const { accounts } = await mail.emailAccounts.list()
const usable = accounts.filter((a) => a.usable)

// Send as one of your mailboxes
const res = await mail.emails.send({
  to: 'ada@example.com',
  subject: 'Your order receipt',
  text: 'Thanks for your order!',
  fromAccount: usable[0].id, // or usable[0].emailAddress
})
console.log('sent from', res.from)

// Inspect the key and balance
const me = await mail.account.me()
console.log(me.credits.balance)