Build fast
Documentation
Everything you need to integrate Dead Simple Email into your application. Start with the quick start guide, then move into the API reference and webhook patterns.
Quick start
Send your first email in a few lines.
Install the SDK, create an inbox, and send an email. Inbound replies arrive as webhooks automatically.
from deadsimple import DeadSimple client = DeadSimple(api_key="dse_...") inbox = client.inboxes.create(name="support-agent") inbox.send( to="customer@example.com", subject="Re: Your request", body="Hi — we've looked into this and here's what we found..." )
Explore
Guides and reference.
Use the guides when you want patterns and working examples. Use the API reference when you need endpoint details and payloads.
API Reference
Full REST reference with endpoints, request/response examples, and downloadable OpenAPI spec.
Getting Started
Go from API key to working inboxes, outbound email, and inbound webhooks in under 5 minutes.
Sign in with Dead Simple
A free OpenID Connect provider where the identity is an agent's inbox. Config for Auth.js, Better Auth, Clerk, Auth0 and Supabase, plus the agent-side sign-in call.
Pay Per Request
No account, no API key. Priced routes answer 402; pay with USDC (x402) or a Stripe card (MPP), retry, and the first paid inbox returns an API key.
Agent Calendar
Every inbox has a calendar. Create events, send real iCalendar invitations, RSVP to invitations that arrive by email, and hand a human a webcal feed. Inbound invites, updates and cancellations land on it automatically.
Metrics Time Series
GET /v1/metrics returns sent, received, bounced, complained, opened, clicked, webhook deliveries and failures, and injection-flagged counts in day or hour buckets, for the account or a set of inboxes.
Prompt-Injection Scanning
Every inbound email is scored before your agent acts on it. The pattern families, how injection_risk and injection_score are derived, the response shape, and the guardrails to pair it with.
Webhook Patterns
Receive inbound messages in real time, verify HMAC signatures, and route events into your agent runtime.
Infrastructure Explained
SPF, DKIM, DMARC, deliverability, and bounce handling — what Dead Simple configures automatically so you don't have to.
Integrations
Works with every major AI framework.
Drop-in integrations for agent frameworks, MCP clients, and Vercel AI SDK. Or use the Python, TypeScript, or Go SDK directly.
MCP Server
Model Context Protocol server with 19 email and calendar tools for any MCP client.
LangChain
Toolkit with send, read, reply, and inbox tools for LangChain agents.
CrewAI
@tool-decorated functions for multi-agent email workflows.
OpenAI Agents SDK
FunctionTool wrappers and raw function definitions for OpenAI agents.
API overview
RESTful, JSON in and out, organized around resources.
The API covers inboxes, messages, threads, contacts, domains, webhooks, templates, drafts, tracking, calendar, metrics, and multi-tenant workspaces. API keys and webhooks can be scoped to specific inboxes with inbox_ids. Here are the core endpoints.
POST /inboxes # Create an inbox GET /inboxes # List inboxes POST /inboxes/:id/send # Send an email GET /inboxes/:id/messages# List messages GET /threads # List conversation threads POST /webhooks # Register a webhook POST /domains # Add a custom domain GET /contacts # List contacts POST /templates # Create an email template POST /drafts # Create a draft for review POST /inboxes/:id/calendar/events # Put an event on the inbox's calendar POST /inboxes/:id/calendar/events/:eid/invite # Send it as an invitation GET /metrics # Time series: sent, received, bounced, opened...