Send transactional emails

Documentation Index

Fetch the complete documentation index at: https://docs.fluxomail.com/llms.txt

Use this file to discover all available pages before exploring further.

1. Create an API key

• In Settings → API → Create API key.
• Restrict scopes to send_email if needed; set a per-minute rate cap if desired.

2. Call the API (idempotent)

BASE=https://api.fluxomail.com
curl -X POST "$BASE/api/v1/emails/send" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Idempotency-Key: send-$(uuidgen)" \
  -d '{
    "to": "user@example.com",
    "subject": "Welcome",
    "content": "Hi",
    "htmlContent": "<p>Hi</p>"
  }'

3. Handle responses

• Success: { sendId, status: "sent", messageId } (reused on duplicate keys)
• 401/403: invalid key or missing scope
• 429: retry after Retry-After seconds with same Idempotency-Key

4. View delivery timeline

• Use GET /api/v1/sends/{id} for messages + events (sent, delivered, opened, clicked).

• From identity is auto-selected from your organization’s active configuration.
• Open/click tracking is injected automatically into HTML.

• API: Send email (v1)
• API: Get send timeline
• API: Idempotency, Rate limits