Developer Docs

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 lists every page with its description, in sidebar order. /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: what the policy pipeline checks on every send.
• Quickstart: sign up, choose a plan, send your first email in five minutes.
• CLI Quickstart: the same from the terminal with molted.
• CLI Reference: every molted command group and flag.
• Authentication: API keys, scoped keys, and claim links for your human.
• Managing API keys: mint, scope, rotate and revoke keys over the API.
• Adoption & Device Flow: add an agent to an existing workspace (molted adopt).
• MCP Server: connect any MCP client.
• Migration Guide: move from Resend, Postmark, or SES.
• Domains: add and verify your sending domains.

Sending

• Sending Email: full API reference for the send endpoint.
• Batch Operations: send, classify, and recommend in bulk.
• Humanizer: LLM-powered email rewriting.
• Policy Simulation: dry-run sends against the policy engine.

Receiving

• Mailboxes: create and manage inbound mailboxes.
• Inbound Email: platform labels, safety classification and routing.

Contacts & compliance

• Contacts & Accounts: sync and manage your contact data.
• Suppressions & Consent: suppression lists and consent management.

Automation

• Journeys: multi-step email sequences.
• Segmentation: dynamic contact segments.
• Experimentation: A/B tests and holdout experiments.

Agents

• Agent Coordination: leases, heartbeats, and consensus votes.
• Event Streaming: real-time SSE event subscriptions.
• Building a Reactive Agent: use molted listen to handle inbound replies and delivery events.

Reference

• Errors: every policy block reason explained.
• Rate Limits: sending limits by plan.
• Billing & Plans: plans, limits, and the Free plan.