Email

Send transactional and marketing emails through the Orbit API

Email

Send beautiful, reliable emails through Orbit’s email infrastructure powered by Resend. Build templates with React Email for pixel-perfect rendering across all clients, or send simple HTML and plain text.

Send an Email

curl -X POST https://orbit-api.devotel.io/api/v1/messages/email \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[e-mail]",
    "from": "[e-mail]",
    "subject": "Your invoice is ready",
    "html": "<h1>Invoice #1234</h1><p>Your invoice for $49.00 is attached.</p>",
    "attachments": [
      {
        "filename": "invoice-1234.pdf",
        "content": "base64-encoded-content"
      }
    ]
  }'

Using Templates

Reference pre-built React Email templates stored in your Orbit account:

curl -X POST https://orbit-api.devotel.io/api/v1/messages/email \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "to": "[e-mail]",
    "from": "[e-mail]",
    "template_id": "tmpl_welcome_email",
    "variables": {
      "name": "Alex",
      "company": "Acme Corp"
    }
  }'

Features

• Transactional email — receipts, notifications, password resets
• Marketing email — campaigns, newsletters, announcements
• React Email templates — build and preview templates with React components
• Attachments — PDF, images, and other file types (up to 25 MB total)
• Custom domains — send from your own domain with DKIM, SPF, and DMARC
• Tracking — open tracking, click tracking, and engagement webhooks
• Suppression lists — automatic bounce and complaint handling

Domain Setup

To send from your own domain, add the following DNS records in Channels > Email > Domains:

Record	Type	Purpose
DKIM	TXT	Email authentication
SPF	TXT	Sender authorization
DMARC	TXT	Delivery policy
Return-Path	CNAME	Bounce handling

Orbit verifies your DNS records automatically — verification typically completes within minutes.

Webhook Events

Event	Description
email.delivered	Email accepted by recipient server
email.opened	Recipient opened the email
email.clicked	Recipient clicked a tracked link
email.bounced	Email bounced (hard or soft)
email.complained	Recipient marked as spam