Send Email

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

POST /api/public/v1/email/send

Preferred public path. Also available via rewrites:

• /api/email/send (canonical handler)
• /api/send-email (legacy alias)

Headers

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

Body

{
  to: string;       // recipient
  subject: string;
  message: string;  // plain text or HTML
  from?: string;    // optional; use a verified domain for production
}

Example

curl -X POST https://notify.cx/api/public/v1/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": "noreply@your-verified-domain.com"
  }'

Response (success)

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

Test / sandbox

Use POST /api/test/send-email with the same body shape for sandbox testing. See Sandbox vs Production.

Interactive schema: /api-docs.