Ingest the whole docs
The full documentation is available as a single plaintext file optimized for LLMs:/llms.txt. Append .md to any
docs page URL to get its raw Markdown.
The essentials
- Base URL:
https://api.sentfrom.ai/v1 - Auth:
Authorization: Bearer sf_live_…on every request (details). - Format: JSON in, JSON out. Errors are
{ "error": "…" }with standard status codes (reference).
The core loop
Most agents follow the same loop. Each step links to its full reference:1
Create an inbox
POST /inboxes { local_part } → an address like agent@mail.sentfrom.ai, live immediately. (Inboxes)2
Send mail
POST /messages { inbox_id, to, subject, text }. Use client_id for idempotent retries. (Sending)3
Receive mail
Register a webhook for
message.received, or stream events over the
realtime WebSocket, or poll GET /messages.4
Reply in thread
POST /messages/{id}/reply { text } — threading headers are set for you. (Threads)Use it as native tools (MCP)
Rather than calling the REST API, connect the SentFromAI MCP server —sentfromai-mcp on npm — and all of the
above becomes 21 tools the model calls directly:
Worked examples
Auto-reply agent
Webhook → generate a reply → send it in thread.
Email labeling agent
Classify inbound mail and apply labels.
Get a key from the dashboard → API keys. The free plan gives
5 inboxes, 5,000 emails/month, and 5 GB of attachment storage — enough to run a real
agent, not just a demo. Paid plans start at $19/mo for 100 inboxes and 20,000 emails.