Comms: Email API · Docs

Send transactional and newsletter email from your App-ID, metered per 10 sends from your credit balance.

Endpoints

Send transactional or newsletter email from your app through the platform email engine. Every message is branded with your app's name, recorded against your App-ID, and billed at the email.send10 rate — 5 credits per 10 sends (minimum one unit), i.e. $0.50 per 1,000 emails. Pro plan and above.

POST/v1/comms/email

GET/v1/comms/email/{send_id}

Send an email

Parameters
Name	Type	Description
`app_id`Required	string	The app whose wallet is charged and whose name brands the message.
`to`Required	string \| string[]	One recipient email, or up to 50 per request (deduplicated).
`subject`Required	string	Subject line, 1–200 characters.
`body_html`Optional	string	HTML body (≤100k chars). At least one of the two bodies is required.
`body_text`Optional	string	Plain-text body (≤100k chars), used as the text alternative.
`reply_to`Optional	string	Optional reply-to address for responses.

Shell

curl https://router-api.intelli-verse-x.ai/v1/comms/email \
  -H "Authorization: Bearer $INTELLIVERSE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "APP_ID",
    "to": ["reader@example.com"],
    "subject": "July product roundup",
    "body_html": "<p>Here is what shipped this month…</p>",
    "body_text": "Here is what shipped this month..."
  }'

Billing & response

Credits are held up front on the recipient count (ceil(recipients / 10) × 5) and settled to accepted sends only — a fully failed batch charges nothing, and a partial batch settles on what was delivered to the mail engine.

JSON

{
  "id": "SEND_ID",
  "app_id": "APP_ID",
  "sku": "email.send10",
  "status": "sent",
  "recipients": 1,
  "sent": 1,
  "credits_held": 5,
  "credits_settled": 5,
  "error": null,
  "created_at": "2026-07-12T00:00:00.000Z"
}

Limits

Up to 50 recipients per request.
2,000 sends per app per UTC day (contact us to raise it for real newsletter volume).
Pro plan or higher — like every comms SKU.

Note

Conversational 1:1 email replies from your app character bill as channel.reply instead — see Channels & webhooks. This endpoint is for app-initiated transactional and newsletter sending.