Skip to main content
Identities
  • Your organization has an active From identity (domain + DKIM). The API uses this by default.
  • Configure in dashboard → Deliverability.
Sends, messages, events
  • Send: idempotent unit of work { sendId, subject, toEmail, status }
  • Message: rendered content + provider response (providerMessageId, Feedback-ID)
  • Events: normalized sent, delivered, bounced, complained, opened, clicked
Idempotency
  • Provide Idempotency-Key per request; duplicates return the original sendId (per org)
Rate limits
  • Per‑minute per‑key. On 429, retry after Retry-After seconds.
Preferences & unsubscribe
  • Public POST /api/unsubscribe records suppression (token/email)
  • GET/POST /api/v1/preferences to read/update category subscriptions
Provider events
  • Events are managed by Fluxomail and correlated via Feedback-ID (preferred) or provider messageId