Skip to main content
  • 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)
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


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)