Configuration
Subusers
Subusers create isolated child accounts with their own API keys, domains, IP pools, and analytics.
Create a Subuser
curl -X POST https://api.postmta.com/v1/subusers -H "Authorization: Bearer pmta_live_xxxx" -H "Content-Type: application/json" -d '{"username":"shop.example.com","email":"admin@shop.example.com","company":"Example Shop Inc","ip_pool":"shared","monthly_volume_limit":500000}'Subuser API Keys
Generate keys scoped to a specific subuser:
curl -X POST https://api.postmta.com/v1/subusers/shop.example.com/keys -H "Authorization: Bearer pmta_live_xxxx" -H "Content-Type: application/json" -d '{"scopes":["messages:send","analytics:read"]}'Assign Domains to a Subuser
curl -X PUT https://api.postmta.com/v1/subusers/shop.example.com/domains -H "Authorization: Bearer pmta_live_xxxx" -H "Content-Type: application/json" -d '{"domains":["mail.shop.example.com"]}'Usage Limits
| Limit | Description |
|---|---|
monthly_volume_limit | Max emails per calendar month |
daily_send_limit | Max emails per 24-hour window |
Suspend / Reactivate
curl -X POST https://api.postmta.com/v1/subusers/shop.example.com/suspend -H "Authorization: Bearer pmta_live_xxxx"
curl -X POST https://api.postmta.com/v1/subusers/shop.example.com/reactivate -H "Authorization: Bearer pmta_live_xxxx"Common Use Cases
- Multi-tenant SaaS - Each customer gets a subuser with their own domain and reputation
- Agencies - Manage multiple client brands from a single master account
- Internal teams - Isolate product, marketing, and transactional email streams