# Flowmails

> Self-hosted email API on Cloudflare — your inbox, outbox, and
> webhooks in your own D1. Flowmails provisions a per-account Worker
> in your Cloudflare account, writes inbound mail to your D1
> database, stores attachments in your R2 bucket, and sends outbound
> through Cloudflare Email Services.

> [!NOTE]
> For the **complete site content as a single text file** (suitable
> for AI ingestion), see [llms-full.txt](/llms-full.txt). Coding
> agents integrating `@flowmails/flowmails-sdk` should install the
> `flowmails-sdk` skill instead —
> `npx skills add wms-why/flowmails-sdk-plugin@flowmails-sdk`.

## Core Documentation

- [Home](/): Platform overview, runtime at a glance, four guarantees, use cases, FAQ.
- [Pricing](/price): Base (free) / Pro ($19) / Enterprise ($199) self-hosted plans, payment methods, pricing FAQ.
- [Docs Hub](/docs): SDK reference overview — install, API, errors, AI agents, v0.2 roadmap.

## SDK Reference

- [Install & Quick start](/docs/install): `pnpm add @flowmails/flowmails-sdk`, mint a key, ship your first send in five minutes.
- [API endpoints](/docs/api): `POST /api/v1/messages` request / response shapes, SDK ↔ wire field renames.
- [Errors & retries](/docs/errors): The FlowmailsError hierarchy, the full HTTP-to-code matrix, retry policy.
- [AI agents integration](/docs/ai-agents): Install the `flowmails-sdk` skill into your coding agent (`npx skills add ...`) and ship a working integration in one prompt.
- [v0.2 roadmap](/docs/roadmap): Reads (`messages.list`, `threads.get`) and outbound webhooks — wire shapes are drafts.

## Blog (operator notes)

- [What is Flowmails?](/blog/what-is-flowmails): Plain-language intro to the platform.
- [Cloudflare API token permissions, explained](/blog/cloudflare-api-token-permissions): Exact scopes Flowmails needs and the audit trail you can show your security reviewer.
- [How to send transactional email from your Cloudflare custom domain](/blog/send-transactional-email-from-cloudflare-domain): Why Email Services + a Worker gets you there in a day.
- [Self-hosting your email data in Cloudflare D1](/blog/self-host-email-data-in-cloudflare-d1): Architectural case for owning your email data — compliance, exports, exit plans.
- [How Workers-native email routing actually processes your inbound mail](/blog/workers-native-email-routing-explained): A tour of Email Routing + Worker + R2 + D1 behind one inbound message.
- [Custom Email Routing on Cloudflare: Build Your Own Address Book](/blog/route-tables-explained): Why catch-all isn't always enough; how Flowmails route tables replace it.
- [Contact the Flowmails team](/blog/contact): Three role-based inboxes (advice, order, bug) and a Twitter handle.

## Legal

- [Terms of Service](/terms): Service terms.
- [Privacy Policy](/legal/privacy): Data handling, residency, your rights under GDPR.
- [Acceptable Use](/acceptable-use): Prohibited content and abuse handling.

## Machine-Readable

- [llms-full.txt](/llms-full.txt): The complete site content concatenated into one Markdown text — read this when an LLM needs full context about Flowmails.
- [Sitemap](/sitemap.xml): Every indexable URL with `<lastmod>` timestamps.
- [Robots](/robots.txt): Crawler directives.

## For AI Coding Agents

- Install the `flowmails-sdk` skill: `npx skills add wms-why/flowmails-sdk-plugin@flowmails-sdk`. It auto-injects the SDK contract — constructor signature, five error classes, retry policy, payload shapes — into every coding-agent session, so the agent never has to re-fetch this site. See [/docs/ai-agents](/docs/ai-agents) for the human setup walkthrough.