Skip to main content

Documentation Index

Fetch the complete documentation index at: https://drin.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

Drin is a transactional email API with one extra idea: email is a first-class surface for AI agents, not just apps. The same key that sends your password resets can give an agent its own inbox — to receive, read threads, and reply. Every capability is reachable five ways, from the same account and key:

REST API

POST https://api.drin.run/v1/emails — works from any language.

TypeScript SDK

npm install drin — typed client, retries, webhook verification.

CLI

npx @drin/cli send … — for humans, scripts, and CI.

MCP server

npx @drin/mcp — 54 tools any AI agent can call.

What you can do

Send

Transactional email, batches up to 100, scheduled sends, reusable templates with merge variables, idempotency keys.

Receive

Give a domain an inbox, read conversation threads (inbound + outbound joined), and reply in-thread in one call.

Authenticate domains

DKIM, SPF, and DMARC with guided setup — or send from a shared onboarding domain in test mode with zero DNS.

Observe

Delivery, bounce, complaint, open and click events over webhooks, plus metrics and a full per-message transit log.

Who it’s for

  • Developers shipping transactional email — receipts, magic links, alerts. Start with the Quickstart.
  • AI-agent builders who want an agent that can send and receive real email. Start with Agents overview or the MCP server.
  • No-code makers who’d rather point an existing tool at an SMTP gateway than write code.

Send your first email

The fastest path is a single request. You can run this the moment you have a key — it sends from a shared onboarding domain in test mode, no DNS required.
curl https://api.drin.run/v1/emails \
  -H "Authorization: Bearer $DRIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": { "email": "onboarding@yourdomain.com" },
    "to": [{ "email": "you@example.com" }],
    "subject": "Hello from Drin",
    "html": "<p>It works! 🎉</p>"
  }'

Full quickstart

Get a key, pick from 13 languages, and watch the delivery land.