# Developer Docs

Source: https://molted.email/docs

API reference and guides for Molted Email - send policy-checked email, handle inbound replies, coordinate agents, and track business outcomes.

Molted Email is agent-native email infrastructure. It gives your agents mailboxes, a policy engine that checks every send, deliverability monitoring, and provider failover, all in one platform. Agents use it through the REST API, the `molted` CLI, or the MCP server.

## Reading these docs as an agent

Every page is also plain Markdown, with no components or HTML:

- Append `.md` to a page URL: `https://molted.email/docs/quickstart.md` (this page is `https://molted.email/docs/index.md`).
- Or request the page URL with `Accept: text/markdown`.
- [`/docs/llms.txt`](https://molted.email/docs/llms.txt) lists every page with its description, in sidebar order. [`/docs/llms-full.txt`](https://molted.email/docs/llms-full.txt) is all of them in one file.
- Each page has a **Copy page** button (the page as Markdown) and a **View as Markdown** link under its title.

## What you can do

- **Send email via API**: `POST /v1/agent/request-send` (or `POST /v1/send/request`) with policy enforcement, rate limiting, and delivery tracking built in.
- **Send in batch**: process up to 500 recipients, classifications, or recommendations in one request.
- **Humanize emails**: LLM-powered rewriting that gives your automated emails a natural, human tone.
- **Simulate sends**: dry-run against the policy engine to pre-check sends without side effects.
- **Track delivery**: see the status of every email: queued, scheduled, pending approval, accepted, sent, delivered, deferred, bounced, complained, or failed.
- **Receive inbound email**: opt-outs, automatic replies and bounces labelled for you, safety-checked, routed, and flagged when a person needs to look.
- **Manage contacts**: sync contacts and accounts, track lifecycle stages and deal stages.
- **Enforce suppressions & consent**: manage suppression lists and record consent for compliance.
- **Build journeys**: create multi-step email sequences with delays, branching, and event-triggered execution.
- **Segment contacts**: define dynamic segments with filter groups, nested logic, and async computation.
- **Run experiments**: A/B test subject lines, templates, and timing with statistical significance.
- **Monitor analytics**: contact fatigue scores, send velocity, deliverability rates, and outcome attribution.
- **Coordinate agents**: register agents, acquire contact leases, and run consensus votes for multi-agent setups.
- **Stream events**: subscribe to real-time events via SSE with filtering and replay support.
- **Manage sending domains**: add and verify your domains with DKIM, SPF, and DMARC records.
- **Manage billing**: choose a plan, view usage, and access the billing portal.

## Quick links

### Getting started

- [Why Molted](https://molted.email/docs/why-molted.md): what the policy pipeline checks on every send.
- [Quickstart](https://molted.email/docs/quickstart.md): sign up, choose a plan, send your first email in five minutes.
- [CLI Quickstart](https://molted.email/docs/cli-quickstart.md): the same from the terminal with `molted`.
- [CLI Reference](https://molted.email/docs/cli.md): every `molted` command group and flag.
- [Authentication](https://molted.email/docs/authentication.md): API keys, scoped keys, and claim links for your human.
- [Managing API keys](https://molted.email/docs/api-keys.md): mint, scope, rotate and revoke keys over the API.
- [Adoption & Device Flow](https://molted.email/docs/adoption.md): add an agent to an existing workspace (`molted adopt`).
- [MCP Server](https://molted.email/docs/mcp-server.md): connect any MCP client.
- [Migration Guide](https://molted.email/docs/migration-guide.md): move from Resend, Postmark, or SES.
- [Domains](https://molted.email/docs/domains.md): add and verify your sending domains.

### Sending

- [Sending Email](https://molted.email/docs/sending-email.md): full API reference for the send endpoint.
- [Batch Operations](https://molted.email/docs/batch-operations.md): send, classify, and recommend in bulk.
- [Humanizer](https://molted.email/docs/humanizer.md): LLM-powered email rewriting.
- [Policy Simulation](https://molted.email/docs/policy-simulation.md): dry-run sends against the policy engine.

### Receiving

- [Mailboxes](https://molted.email/docs/mailboxes.md): create and manage inbound mailboxes.
- [Inbound Email](https://molted.email/docs/inbound.md): platform labels, safety classification and routing.

### Contacts & compliance

- [Contacts & Accounts](https://molted.email/docs/contacts.md): sync and manage your contact data.
- [Suppressions & Consent](https://molted.email/docs/suppressions.md): suppression lists and consent management.

### Automation

- [Journeys](https://molted.email/docs/journeys.md): multi-step email sequences.
- [Segmentation](https://molted.email/docs/segmentation.md): dynamic contact segments.
- [Experimentation](https://molted.email/docs/experimentation.md): A/B tests and holdout experiments.

### Agents

- [Agent Coordination](https://molted.email/docs/agents.md): leases, heartbeats, and consensus votes.
- [Event Streaming](https://molted.email/docs/events.md): real-time SSE event subscriptions.
- [Building a Reactive Agent](https://molted.email/docs/reactive-agent-guide.md): use `molted listen` to handle inbound replies and delivery events.

### Reference

- [Errors](https://molted.email/docs/errors.md): every policy block reason explained.
- [Rate Limits](https://molted.email/docs/rate-limits.md): sending limits by plan.
- [Billing & Plans](https://molted.email/docs/billing.md): plans, limits, and the Free plan.