Postfleet documentation

Email infrastructure for AI agents. Every endpoint lives under the canonical /api/v1/ prefix, and every page below is fetchable as verbatim markdown at /docs/<page>/raw — the surface your agent should read. A machine index is at /llms.txt.

QuickstartGet an API key, send your first email, receive inbound mail via webhook, and connect over MCP.Authentication & key scopingBearer pf_ keys, mailbox-bound scoping, the data-plane vs control-plane split, and anti-enumeration 404s.Sending & idempotencyPOST /api/v1/send, the single-recipient rule, client_id duplicate protection with the full replay table, and provider-unknown semantics.Drafts & human-in-the-loopVoluntary vs. forced drafts, the pending_approval flow, content_hash concurrency at approval, tombstones, and the MCP draft tools.Send listsAllow/blocklist precedence, address normalization, exact-label matching, and the 403 send_blocked_by_list shape.WebhooksThe message.received event, event_id dedup, the custom HMAC signature recipe with a copy-pasteable verifier, at-least-once retries, and dead-letter redrive.MCP setupConfigure the Postfleet MCP server with a bearer key, the full tool list, and how to handle the 202 pending-approval outcome.API referenceThe full /api/v1 REST surface — every endpoint, grouped by resource, with a link to the machine-readable OpenAPI description.