Twilio - Accounts
Twilio - Accounts
Manage Twilio account credentials and hierarchy — create subaccounts, rotate auth tokens, and look up account metadata.
Tight integration with Twilio billing
Strictly account-level — does not cover messaging/voice features
Grab the master ACCOUNT_SID / AUTH_TOKEN from console, POST /Accounts.json to create a subaccount. All subaccount calls authenticate with the master credentials.
Uptime · 30-day window
About this API
Twilio Accounts API is the foundation for multi-tenant Twilio architectures. SaaS providers use it to spin up an isolated subaccount per customer — each gets its own SID, AuthToken, and phone-number assets, but billing and admin authority stays on the master account. Typical use cases: customer isolation for compliance, per-customer rate limiting, and the ability to suspend a single tenant without affecting others. The API also covers AuthToken rotation (a critical security primitive) and current balance lookup.
What you can build
- 1Spin up isolated Twilio subaccounts per customer for billing separation
- 2Rotate auth tokens en masse after a security audit
- 3Programmatically check account balance and usage
- 4Suspend dormant subaccounts
Strengths & limitations
Strengths
- Tight integration with Twilio billing
- Master account inherits permission across all subaccounts
- First-class coverage in every official Twilio SDK
Limitations
- Strictly account-level — does not cover messaging/voice features
- AuthToken rotation invalidates the old token instantly; coordinate deploys
Example request
curl https://support.twilio.com/<endpoint>Getting started
Grab the master ACCOUNT_SID / AUTH_TOKEN from console, POST /Accounts.json to create a subaccount. All subaccount calls authenticate with the master credentials.
FAQ
Can I transfer a phone number from a subaccount back to the master?+
Yes — call PhoneNumbers update with AccountSid set to the master SID. Ownership moves; the number is not re-issued.
Will rotating the AuthToken break in-flight calls or messages?+
No. Twilio maintains active sessions with internal credentials. But any new request made with the old token is rejected immediately.
Can the master account see subaccount usage?+
Yes. Authenticate with master credentials and pass the subaccount SID as AccountSid — you get full visibility into Usage, Messages, Calls.
Technical details
- Auth type
- unknown
- Pricing
- unknown
- Protocols
- REST
- SDKs
- python, javascript, typescript, go, java, ruby, php, csharp
- Response time
- 159 ms
- Last health check
- 5/12/2026, 7:38:31 AM
More from Twilio
Twilio's core API for voice calls, SMS, Verify, and other programmable communications, billed per usage.
Twilio Autopilot is a sunset conversational-AI platform formerly used for IVR bots and NLU tasks (now superseded; migrate to Voice Intelligence or third-party LLMs).
Bulk-export Twilio usage history (Messages, Calls) as compressed daily JSON files — for audit, billing reconciliation, or data-warehouse ingestion.
Twilio Chat v1 is a sunset real-time chat SDK backend (superseded by Conversations). Existing projects still work; new projects should use Conversations API.
Twilio Content API centrally manages messaging templates across channels (WhatsApp/SMS/Messenger), including WhatsApp template approval flow and dynamic variable binding.
Twilio Conversations unifies multi-channel (SMS/MMS/WhatsApp/Chat/Email) messaging into a single "conversation" primitive with multi-participant, persistence, and read receipts.
Twilio Events streams Twilio platform events (message delivery, call state changes, quota alerts) via a unified webhook bus — replacing scattered per-endpoint webhook configs.
Twilio Flex is a programmable contact-center platform for call centers — agent desktop, IVR/ACD routing, and deep integration with Twilio's full communications stack.