Send Email

POST /api/email/send — send a transactional email with to, from, subject, and message.

POST /api/email/send

Canonical send endpoint. Also available via rewrite aliases:

• /api/send-email

Headers

Content-Type: application/json
x-api-key: your_api_key

Body

{
  to: string;       // recipient
  from: string;     // bare email or `Name <email@verified-domain.com>`
  subject: string;
  message: string;  // plain text or HTML, max 100,000 characters
}

from is required. Display names are taken from from (for example Circuit <notifications@yourdomain.com>). Verified apex domains also cover subdomains (e.g. mail.yourdomain.com). Use sent-with@mail.notify.cx for the Notify platform sender when you have not verified a domain yet.

Example

curl -X POST https://notify.cx/api/email/send \
  -H "Content-Type: application/json" \
  -H "x-api-key: $NOTIFY_API_KEY" \
  -d '{
    "to": "user@example.com",
    "subject": "Hello from Notify",
    "message": "<p>It works.</p>",
    "from": "Circuit <noreply@your-verified-domain.com>"
  }'

Response (success)

{
  "success": true,
  "data": {
    "messageId": "ses-message-id"
  }
}

Test / sandbox

Use POST /api/email/send/test with the same body shape for sandbox testing (append /test to the production send path). See Sandbox vs Production.

Interactive schema: /api-docs.