Question
What is a Billing Group?
Environment
Twilio Console
Answer
A Billing Group is a shared financial framework for one or more accounts within your Organization and standardizes how you are invoiced. By formalizing the relationship between your Organization and its individual accounts, a Billing Group ensures that critical details—such as currency, billing entity, payment method, and tax information—remain consistent across your entire environment.
The Big Picture: From Account-Level to Organization-Level
In the legacy Console, billing was managed at the individual account level. Consolidating charges required a manual "link and designate" process, where one specific account had to be set as the primary hub for all others.
In the new Twilio Console, billing is elevated to the Organization level. This shift offers three primary advantages:
- Unified Financial View: You receive one consolidated invoice and a holistic view of your data.
- Decentralized Hierarchy: There is no longer a need to designate a "primary" account. Billing now exists independently of account ownership, allowing for a more flexible architecture.
- Granular Access Control: Organization level billing management provides new roles and gives you more precise control. You can define exactly who can view or modify sensitive financial information.
Summary: Billing Groups provides a more scalable and secure way to manage global usage.
Key Terminology Shift
| Feature | legacy Twilio Console | Twilio Console |
| Primary Billing Unit | Account SID (ASID) | Billing Group |
| Management Level | Individual Account Settings | Organization Settings |
| Grouping Logic | Stored Value Account (SVA) | Billing Group (Multi-Account) |
| Access Control | Account-level Roles | Organization-level Roles |
Core Rules and Guardrails
To prevent billing and tax errors, the Commerce Platform enforces strict rules for Billing Groups:
- Single Invoice: One Billing Group generates only one invoice.
- Shared Attributes: All accounts within the same Billing Group must share the same Twilio billing entity, currency, tax address, and pricing model.
- Organizational Limits: Accounts from different Organizations cannot be grouped into the same Billing Group.
How Billing Groups are Created
You do not need to manually create a Billing Group.
- Net-New Accounts: A Billing Group is automatically created when you upgrade an account from Trial to Pay-As-You-Go (PAYG). Trial accounts do not get assigned a Billing Group because there is no billing obligation yet.
- PAYG Accounts: PAYG accounts have a strict 1:1 relationship with a Billing Group, multiple PAYG accounts cannot be consolidated into one Billing Group.
- Invoiced Accounts: If your combined spend meets an Annual Recurring Revenue (ARR) threshold and you pass a credit check, you can be approved for invoicing. Once approved, Twilio Support can consolidate multiple accounts into a single invoiced Billing Group.
- Existing Accounts: If you are a current customer already on the legacy Twilio Console, Billing Groups have already been automatically created for your accounts and organization and ready for your move onto the new Twilio Console experience.