# Fluxomail Documentation

## Docs

- [Authentication](https://docs.fluxomail.com/api-reference/fluxomail/authentication.md): Server-side API keys and scopes
- [Fluxomail CLI](https://docs.fluxomail.com/api-reference/fluxomail/cli.md): Send emails and work with events from your terminal
- [CORS & headers](https://docs.fluxomail.com/api-reference/fluxomail/cors.md): Allowed origins, methods, and headers for cross‑origin requests
- [Errors](https://docs.fluxomail.com/api-reference/fluxomail/errors.md): Error format, common causes, and HTTP statuses
- [Events API](https://docs.fluxomail.com/api-reference/fluxomail/events.md): Backfill and stream email events
- [Get send timeline](https://docs.fluxomail.com/api-reference/fluxomail/get-send.md): Fetch messages and events for a send
- [Idempotency](https://docs.fluxomail.com/api-reference/fluxomail/idempotency.md): Safely retry POST requests without duplication
- [Preferences & unsubscribe](https://docs.fluxomail.com/api-reference/fluxomail/preferences.md): Token-based unsubscribe and subscription categories
- [Rate limits](https://docs.fluxomail.com/api-reference/fluxomail/rate-limits.md): Per-minute throttles and Retry-After guidance
- [Response Schemas](https://docs.fluxomail.com/api-reference/fluxomail/schemas.md): Minimal TypeScript snapshots for send and timeline responses
- [Scopes](https://docs.fluxomail.com/api-reference/fluxomail/scopes.md): Least-privilege capabilities for API keys
- [Send email](https://docs.fluxomail.com/api-reference/fluxomail/send-email.md): Send a single email using your active identity
- [Send email (global)](https://docs.fluxomail.com/api-reference/fluxomail/send-global.md): Alternate send endpoint with global usage tracking
- [Templates (beta)](https://docs.fluxomail.com/api-reference/fluxomail/templates.md): Create, manage, and render email templates via the SDK
- [Webhook verification (optional)](https://docs.fluxomail.com/api-reference/fluxomail/webhook-verification.md): Verify signatures and parse event payloads on your server
- [Provider Events (Managed)](https://docs.fluxomail.com/api-reference/fluxomail/webhooks.md): Deliveries, bounces, complaints, opens, clicks — managed by Fluxomail
- [Introduction](https://docs.fluxomail.com/api-reference/introduction.md): Overview of the Fluxomail API: base URL, auth, idempotency, limits, and errors
- [API Roadmap](https://docs.fluxomail.com/api-reference/roadmap.md): Planned improvements to reliability, clarity, and DX
- [SDKs & Clients](https://docs.fluxomail.com/api-reference/sdks.md): Minimal API clients and usage examples
- [Versioning & Changelog](https://docs.fluxomail.com/api-reference/versioning.md): API stability, deprecations, and how changes are communicated
- [Concepts](https://docs.fluxomail.com/concepts/core-model.md): Core model — identities, sends, messages, events, preferences
- [Security Model](https://docs.fluxomail.com/concepts/security-model.md): Authentication, scopes, webhook verification, and unsubscribe tokens
- [API keys & scopes](https://docs.fluxomail.com/guides/api-keys-and-scopes.md): Least‑privilege access, rotation, and limits
- [Attachments & Limits](https://docs.fluxomail.com/guides/attachments-and-limits.md): How to send attachments, limits, and entitlements
- [Categories from HubSpot properties](https://docs.fluxomail.com/guides/audience-categories-from-hubspot.md): Map HubSpot contact properties (e.g., lifecycle stage, lead status) to Audience Categories for targeted sending.
- [Billing & usage](https://docs.fluxomail.com/guides/billing-and-usage.md): Understand usage counts and limits
- [Browser Auth Pattern](https://docs.fluxomail.com/guides/browser-auth-pattern.md): Secure token minting for client-side SDK and SSE
- [Release Notes](https://docs.fluxomail.com/guides/changelog.md): SDK and API changelog
- [Contacts & segmentation](https://docs.fluxomail.com/guides/contacts-and-segmentation.md): Import contacts and target audiences
- [Engagement Timeline UI](https://docs.fluxomail.com/guides/engagement-timeline.md): Understand delivery, opens, clicks, bounces, and complaints with a readable, metadata‑rich timeline.
- [Connect HubSpot (OAuth + Webhooks)](https://docs.fluxomail.com/guides/integrations-hubspot.md): Step‑by‑step to connect HubSpot to Fluxomail, configure OAuth + webhooks, and import contacts reliably.
- [Migration checklist](https://docs.fluxomail.com/guides/migration-checklist.md): Move from another provider with minimal downtime
- [Monitoring & Events](https://docs.fluxomail.com/guides/monitoring-and-webhooks.md): Delivery timeline, provider events, and tracking
- [Preferences & unsubscribe](https://docs.fluxomail.com/guides/preferences-and-unsubscribe.md): One‑click unsubscribe and category subscriptions
- [Preflight Checks (Review)](https://docs.fluxomail.com/guides/preflight-checks.md): Verify domain, unsubscribe, and policy health before sending.
- [Quickstart](https://docs.fluxomail.com/guides/quickstart.md): Create an API key, send your first email, and view the timeline
- [Realtime events (SSE)](https://docs.fluxomail.com/guides/realtime-events.md): Stream delivery/open/click events without webhooks using Server‑Sent Events
- [Scale safely with policies](https://docs.fluxomail.com/guides/scaling-with-policies.md): Warmup, throttling, and compliance guardrails
- [Scheduling Campaigns](https://docs.fluxomail.com/guides/scheduling-campaigns.md): Schedule email campaigns to send at a specific date and time with FluxoMail’s built‑in scheduler.
- [Advanced Segments (AND/OR/NOT)](https://docs.fluxomail.com/guides/segments-advanced.md): Build powerful audience segments with logical rules and time‑windowed engagement predicates.
- [Send transactional emails](https://docs.fluxomail.com/guides/sending-transactional.md): Use the v1 API with idempotency and rate limits
- [Set up deliverability](https://docs.fluxomail.com/guides/setup-deliverability.md): Verify domain, configure DNS, and enable delivery signals
- [Templates Versioning & Publishing](https://docs.fluxomail.com/guides/templates-versioning.md): Manage drafts, publish versions, review history, and restore prior revisions for email templates.
- [Webhooks Setup & Signing](https://docs.fluxomail.com/guides/webhooks-setup.md): Configure a webhook endpoint to receive signed email events from FluxoMail.
- [AI Assistants with ROI](https://docs.fluxomail.com/solutions/ai-assistants-roi.md): Subject/content suggestions validated by controlled experiments
- [Compliant Onboarding (No Surprise Suspensions)](https://docs.fluxomail.com/solutions/compliant-onboarding.md): Smarter verification and transparent review to get you sending fast
- [Deliverability Autopilot](https://docs.fluxomail.com/solutions/deliverability-autopilot.md): Automate domain setup, warmup, and reputation monitoring end‑to‑end
- [Developer Console (Logs & Replay)](https://docs.fluxomail.com/solutions/developer-console.md): Search, inspect, and replay your email pipeline for faster debugging
- [Modern Editor & Templates](https://docs.fluxomail.com/solutions/editor-templates.md): Fast editor and flexible templates for teams
- [Event‑Driven Journeys](https://docs.fluxomail.com/solutions/event-driven-journeys.md): Visual automations triggered by product events and profiles
- [Integrations & Data](https://docs.fluxomail.com/solutions/integrations-data.md): Connect product data and tools without brittle glue
- [One‑Click Migration Toolkit](https://docs.fluxomail.com/solutions/migration-toolkit.md): Import templates, contacts, and journeys — switch without the stitch
- [Predictable Pricing](https://docs.fluxomail.com/solutions/predictable-pricing.md): Transparent, usage‑based pricing with guardrails and visibility
- [Responsive Support](https://docs.fluxomail.com/solutions/responsive-support.md): Fast, technically competent help when it matters most
- [Troubleshooting](https://docs.fluxomail.com/troubleshooting/sending.md): Common errors and delivery checks

## OpenAPI Specs

- [openapi.fluxomail](https://docs.fluxomail.com/api-reference/openapi.fluxomail.json)