- What: Subaccounts are isolated environments under your main Plivo account — each with its own Auth ID/Auth Token, separate call/message logs, and independent webhooks — for multi-tenant SaaS, resellers, and dev/staging/production separation
- Billing: All charges deduct from the parent account’s balance; subaccounts have no separate payment methods
- Access: Subaccount credentials (Auth ID prefix
SA) reach only their own resources; the main account (MA) can access all resources and all subaccounts - Numbers: Each phone number belongs to one account only; numbers transfer to the main account when a subaccount is deleted (unless
cascade=true)
How Subaccounts Work
Each subaccount has:- Unique Auth ID and Auth Token
- Separate call/message logs
- Independent webhooks
Use Cases
Billing
Subaccounts share the main account’s credit balance:- All charges deduct from main account
- No separate payment methods per subaccount
- Track usage per subaccount via API for client invoicing
Credentials
Subaccounts cannot access main account or other subaccount resources.
Phone Numbers
- Assign numbers when renting or transfer later
- Each number belongs to one account only
- Numbers transfer to main account when subaccount deleted (unless cascade=true)