Pro API Overview

The Pro API gives you programmatic control over custom domains, webhooks, API tokens, and mailbox management.

Base URL

https://api.mail.cx/pro/api

Authentication

All Pro endpoints require an API token. Create one in the Pro dashboard under Tokens (prefixed with tm_pro_).

curl https://api.mail.cx/pro/api/accounts \
  -H "Authorization: Bearer tm_pro_xxxxxxxxxxxx"

Pro Features

Feature	Description
Accounts	Create and manage multiple mailboxes
Domains	Add custom domains with DNS verification
Webhooks	Receive HTTP callbacks when emails arrive
API Tokens	Long-lived tokens for server-to-server access

Pro Limits

Resource	Limit
Webhooks	1 per user
Storage/mailbox	50 MB

INFO

Mailbox and domain limits are configured per account and may vary by plan.

Endpoints

Method	Path	Description
GET	/pro/api/accounts	List mailboxes
DELETE	/pro/api/accounts/{id}	Delete a mailbox
PUT	/pro/api/accounts/{id}/reset-password	Reset mailbox password
GET	/pro/api/accounts/{id}/messages	List messages for a mailbox
GET	/pro/api/domains	List custom domains
POST	/pro/api/domains	Add a custom domain
POST	/pro/api/domains/{id}/verify	Verify domain DNS
DELETE	/pro/api/domains/{id}	Delete a custom domain
GET	/pro/api/webhooks	List webhooks
POST	/pro/api/webhooks	Create a webhook
DELETE	/pro/api/webhooks/{id}	Delete a webhook
POST	/pro/api/webhooks/{id}/rotate	Rotate webhook secret
GET	/pro/api/webhooks/{id}/deliveries	List delivery attempts
GET	/pro/api/tokens	List API tokens
POST	/pro/api/tokens	Create an API token
DELETE	/pro/api/tokens/{id}	Revoke an API token