Pro Features

Pro unlocks advanced capabilities on top of the unified API. The core email operations (create account, read messages, etc.) use the same endpoints as free users — Pro adds management features on top.

What's the Same

Free and Pro users use identical endpoints for email operations:

POST /api/accounts                              → create account
POST /api/token                                 → email login
GET  /api/accounts/{account_id}/messages        → read emails
GET  /api/accounts/{account_id}/messages/{id}   → read single email

What Pro Adds

Pro features are under /api/user/:

Feature	Endpoints	Description
User Management	GET /api/user/me, GET /api/user/accounts	View profile, list all accounts
Custom Domains	/api/user/domains	Add your own domains for receiving email
Webhooks	/api/user/webhooks	Get HTTP callbacks when emails arrive
API Tokens	/api/user/tokens	Long-lived tokens for server-to-server access
SMTP Sandbox	/api/user/sandbox	Capture and inspect outgoing emails

Authentication

Pro endpoints accept two token types:

# Pro JWT (from login)
curl https://api.mail.td/api/user/me \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

# Pro API Token (long-lived)
curl https://api.mail.td/api/user/me \
  -H "Authorization: Bearer tm_pro_xxxxxxxxxxxxxxxxxxxx"

Pro Limits

Resource	Limit
Rate limit	50 requests/second per user
Storage per account	50 MB
Webhooks	1 per user
Accounts and domains	Varies by plan

Getting Started with Pro

1. Register for a Pro account (email/password or Google/GitHub)
2. Create an API token in the Pro dashboard or via POST /api/user/tokens
3. Use the API token (tm_pro_...) to authenticate all API requests
4. Create accounts on your custom domains
5. Set up webhooks for real-time notifications