Mail.td APIDeveloper Email Platform

Unified REST API for creating email addresses and receiving emails. Same endpoints for free and Pro users.

⚡

Unified REST API

One set of endpoints for all users. Create accounts, fetch emails, download attachments — free and Pro use the same paths.

🔒

Token-based Auth

Simple bearer token authentication. Create an API token and start making requests instantly.

📡

Webhooks

Get instant HTTP callbacks when new emails arrive — no polling required.

🧪

SMTP Sandbox

Capture outgoing emails from your app. Point your SMTP config at Mail.td and inspect every message.

🚀

Pro Features

Custom domains, webhooks, API tokens, higher rate limits, and multi-account management.

🤖

LLM & AI Agent Ready

Structured, LLM-optimized documentation available for AI assistants and coding agents.

Quick Start

bash

# 1. Get available domains
curl https://api.mail.td/api/domains

# 2. Create a mailbox
curl -X POST https://api.mail.td/api/accounts \
  -H "Authorization: Bearer td_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"address":"myname@mail.td","password":"mypassword123"}'

# 3. Fetch messages (use the account ID from step 2)
curl https://api.mail.td/api/accounts/{account_id}/messages \
  -H "Authorization: Bearer td_xxxxxxxxxxxxxxxxxxxx"

How it works

Get domains — Fetch the list of available email domains
Create account — Pick a domain and create an email address (returns an account ID)
Use the address — Give the address to any service that requires email verification
Fetch messages — Use the account ID to read your emails

For AI assistants

A structured, LLM-optimized version of this documentation is available at /llms.txt. It includes API routing instructions, endpoint summaries, and integration guidance formatted for accurate code generation. Learn more