Skip to main content

​
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": "user@example.com",
    "from": "notifications@yourdomain.com",
    "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": "user@example.com",
    "from": "hello@yourdomain.com",
    "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:
RecordTypePurpose
DKIMTXTEmail authentication
SPFTXTSender authorization
DMARCTXTDelivery policy
Return-PathCNAMEBounce handling
Orbit verifies your DNS records automatically — verification typically completes within minutes.

​
Webhook Events

EventDescription
email.deliveredEmail accepted by recipient server
email.openedRecipient opened the email
email.clickedRecipient clicked a tracked link
email.bouncedEmail bounced (hard or soft)
email.complainedRecipient marked as spam