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.
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 11 email 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, and multi-tenant pods. 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