TypeScript

Quick start with the TypeScript SDK.

Install the SDK in your Replit project and set DSE_API_KEY as a Replit Secret.

index.ts
import { DeadSimple } from "deadsimple";

const client = new DeadSimple(process.env.DSE_API_KEY!);

// Create an inbox for your agent
const inbox = await client.inboxes.create({
  displayName: "Replit Agent",
});
console.log(`Inbox: ${inbox.email}`);

// Send an email
await client.messages.send({
  inboxId: inbox.inbox_id,
  to: "user@example.com",
  subject: "Hello from Replit",
  textBody: "This was sent from a Replit app.",
});

// Read messages
const messages = await client.messages.list(inbox.inbox_id);
console.log(`${messages.count} messages`);

Python

Or use the Python SDK.

Same pattern, same API key — just a different language.

main.py
import os
from deadsimple import DeadSimple

client = DeadSimple(api_key=os.environ["DSE_API_KEY"])

# Create an inbox
inbox = client.inboxes.create(display_name="Replit Agent")
print(f"Inbox: {inbox.email}")

# Send an email
client.messages.send(
    inbox_id=inbox.inbox_id,
    to="user@example.com",
    subject="Hello from Replit",
    text_body="This was sent from a Replit app.",
)

# Read messages
messages = client.messages.list(inbox.inbox_id)
print(f"{messages.count} messages")

AI agents

Build email-capable agents on Replit.

Combine with any AI agent framework. Dead Simple Email has native integrations for LangChain, CrewAI, OpenAI Agents, and Vercel AI SDK.

agent.ts
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";
import { getTools } from "deadsimple/ai";

const tools = getTools(process.env.DSE_API_KEY!);

const result = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "Create an inbox and send a welcome email to hello@example.com",
});

Ready to build?

Create a free account and start integrating in minutes.

API Reference Get Started Free