Email

Smooven provides a high-performance email delivery system with dedicated SMTP relay, per-tenant DKIM signing, and a visual template builder.

When to use email

• Transactional emails: order confirmations, password resets, invoices
• Marketing campaigns: newsletters, product updates, promotional offers
• Detailed content: email supports rich HTML, attachments, and long-form messaging
• Audit trails: email provides a permanent record that recipients can reference later

Sending an email

curl -X POST https://api.smooven.io/v1/agent/notify \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "to": "user@example.com",
    "email": {
      "from": "notifications@yourdomain.com",
      "subject": "Your order has been confirmed",
      "html": "<h1>Order Confirmed</h1><p>Thank you for your purchase, Sarah.</p>",
      "text": "Order Confirmed. Thank you for your purchase, Sarah."
    }
  }'

Email features

Feature	Description
Dedicated relay	High-deliverability SMTP infrastructure without shared IP reputation concerns
Per-tenant DKIM	Each sending domain gets its own DKIM signing key
SPF/DMARC	Full DNS authentication support for maximum deliverability
White-label domains	Send from your own domain with custom envelope headers
Visual builder	Drag-and-drop React-based template builder in the dashboard
Template variables	Dynamic content substitution using {{variable}} syntax

Domain setup

Before sending email, configure your sending domain in the Smooven dashboard:

1. Add your domain under Settings > Email > Sending Domains
2. Add DNS records: Smooven provides the SPF, DKIM, and DMARC records to add to your DNS
3. Verify: Smooven checks your DNS records and confirms the domain is ready

Record type	Purpose
SPF (TXT)	Authorises Smooven’s servers to send on your behalf
DKIM (TXT)	Cryptographic signature proving message authenticity
DMARC (TXT)	Policy for handling authentication failures

Using templates

Create reusable email templates in the dashboard, then reference them by ID:

curl -X POST https://api.smooven.io/v1/agent/notify \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "email",
    "to": "user@example.com",
    "email": {
      "from": "notifications@yourdomain.com",
      "template_id": "tmpl_order_confirmation",
      "variables": {
        "customer_name": "Sarah",
        "order_id": "ORD-1234",
        "total": "$99.00"
      }
    }
  }'

Delivery tracking

Smooven tracks email delivery events through the entire lifecycle:

• queued: email accepted for delivery
• sent: email handed off to receiving mail server
• delivered: receiving server accepted the message
• opened: recipient opened the email (via tracking pixel)
• clicked: recipient clicked a tracked link
• bounced: delivery permanently failed (hard bounce)
• deferred: temporary delivery failure, will retry
• complained: recipient marked as spam

Set up webhooks to receive real-time updates for these events.