API Documentation · v1

Email infrastructure
for developers

Create inboxes, receive mail, parse attachments — one REST API. Sign in once, mint a td_ token, use it on every endpoint. Trial accounts get fewer ops; Pro unlocks custom domains, webhooks, and sandbox.

Quick start →How auth works

~/mail.td — zsh

$ curl https://api.mail.td/api/domains
{
"domains": [
  {
    "id": "38b711da-77bf-...",
    "domain": "example.com",
    "default": true,
    "sort_order": 0,
    "pro_only": false
  }
]
}
$ 

§01 · Start here

Four steps in, mail arriving

01 · 60 secondsQuick startCreate an inbox and read your first email in under a minute — no account required.→02 · BearerAuthenticationThree token flavors under one Authorization header. The server picks the right one.→03 · Per-IP, per-planRate limitsRedis sliding window. 8 req/s public, 10 req/s Pro. Monthly ops quota for the rest.→04 · Status + codeError handlingOne error shape. Predictable codes. Know which to retry, which to fix, which to ignore.→

§02 · Surfaces

Three tiers, one bearer header

Core APIMailbox primitives, REST-nativeCreate mailboxes, list messages, download attachments and raw MIME. Works with any td_ token — trial and Pro tiers alike.11endpointsAnytierPro APICustom domains, webhooks, account opsBring your domain. Receive delivery webhooks with HMAC signatures. Manage mailboxes and rotate tokens at the account level.17endpointsProtierSMTP SandboxCapture outbound mail in test & CIPoint your app at a sandbox SMTP host. Messages are captured, never delivered. Inspect headers, bodies, SPF/DKIM/DMARC verdicts.8endpointsPort25

§03 · The only unauthenticated endpoint

Domain discovery

Callable without a bearer token

GET/api/domainsBrowse available domains before signing up