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

Authentication

Pro endpoints accept two token types:

# Pro API Token
curl https://api.mail.td/api/user/me \
  -H "Authorization: Bearer td_xxxxxxxxxxxxxxxxxxxx"

Pro Limits

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

Getting Started with Pro

1. Sign in with Google or GitHub (first login creates your Pro account)
2. Create an API token in the Pro Dashboard
3. Use the API token (td_...) to authenticate all API requests
4. Create accounts on your custom domains
5. Set up webhooks for real-time notifications