Documentation

Quick Start

Send your first email in 3 lines

Install the Python SDK and start sending immediately. The API handles DNS, deliverability, and infrastructure for you.

          
          
          
          send_email.py
        

import deadsimple

# Initialize the client
client = deadsimple.Client("dse_your_api_key")

# Create an inbox
inbox = client.inboxes.create(
    name="sales-agent",
    domain="outreach.yourcompany.com"
)

# Send an email
client.emails.send(
    from_inbox=inbox.id,
    to="prospect@example.com",
    subject="Quick question about your workflow",
    body="Hi — I noticed you're using..."
)

# Listen for replies via webhook
# POST https://yourapp.com/webhooks/email
# { "event": "email.received", "inbox_id": "...", "from": "...", "body": "..." }
        

Install the SDK: pip install deadsimple

Explore

Browse the docs

Guides, references, and resources to help you build with Dead Simple Email.

📖

API Reference

Complete REST API documentation with request/response examples for every endpoint. Coming with launch.

🐍

Python SDK

Official Python client library. Install with pip, authenticate with your API key, and start building in minutes.

🚀

Getting Started

Step-by-step guide to creating your first inbox, sending an email, and setting up webhooks for inbound messages.

🔌

Webhooks Guide

Configure real-time webhooks to receive notifications when emails arrive, bounce, or are opened.

🔐

Authentication

Learn how API keys work, best practices for key management, and how to rotate keys safely. Coming with launch.

⚡

Rate Limits

Understand rate limits per plan, how to read rate limit headers, and strategies for staying within your quota. Coming with launch.

API Overview

RESTful and predictable

The API follows standard REST conventions. JSON in, JSON out. Consistent error responses. Intuitive resource naming.

          
          
          
          API Endpoints
        

# Base URL
https://api.deadsimple.email/v1

# Inboxes
POST   /inboxes              # Create an inbox
GET    /inboxes              # List all inboxes
GET    /inboxes/:id          # Get inbox details
DELETE /inboxes/:id          # Delete an inbox

# Emails
POST   /emails               # Send an email
GET    /emails               # List emails for an inbox
GET    /emails/:id           # Get email details

# Webhooks
POST   /webhooks             # Register a webhook
GET    /webhooks             # List webhooks
DELETE /webhooks/:id         # Remove a webhook

# Domains
POST   /domains              # Add a custom domain
GET    /domains/:id/verify   # Check DNS verification
        

All requests require an Authorization: Bearer ds_your_api_key header.