Skip to main content
Subaccounts let you create isolated environments under your main Plivo account.

​
How Subaccounts Work

Each subaccount has:
  • Unique Auth ID and Auth Token
  • Separate call/message logs
  • Independent webhooks
All charges deduct from the parent account balance.

​
Use Cases

Use CaseDescription
Multi-tenant SaaSIsolate each customer’s traffic and logs
Reseller/White-labelManage client accounts, track usage for billing
Environment separationSeparate dev, staging, production
Department trackingTrack usage by business unit

​
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

Account TypeAuth ID PrefixAccess
Main accountMAAll resources + all subaccounts
SubaccountSAOnly its own resources
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)