SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

What is a Billing Group?

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

Featurelegacy Twilio ConsoleTwilio Console
Primary Billing UnitAccount SID (ASID)Billing Group
Management LevelIndividual Account SettingsOrganization Settings
Grouping LogicStored Value Account (SVA)Billing Group (Multi-Account)
Access ControlAccount-level RolesOrganization-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.  


 

Have more questions? Submit a request
Powered by Zendesk