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.

Manage Billing Groups during Organizational Change

Objective

Managing the Billing Groups during organizational changes will help maintain financial simplicity while your organization grows. 

 

Environment 

Twilio Console 

 

Procedure

Billing Group Lifecycle Scenarios

1. Account Transfers (Moving Between Orgs)

You can still move accounts between Organizations to change ownership.

  • Billing Follows the Account: When an account moves from Org A to Org B, its associated Billing Group is automatically reassigned to the destination Organization.
  • No Interruption: This ensures that billing ownership and access remain aligned without disrupting active services.
  • Access Reset: Users in the source Organization will immediately lose billing access to that group, while Owners in the destination Organization will automatically gain visibility.

2. Merging Organizations

When a customer consolidates multiple Organizations, the transition is designed to be seamless.

  • Preservation of Data: All Billing Groups from the "source" Organization move to the "surviving" Organization.
  • Attribute Retention: Each group preserves its existing pricing, legal entity, currency, tax address, and payment methods.
  • Role Continuity: Users with specific roles, like Billing Group Admin or Billing Group Viewer, will typically retain those roles post-merge to maintain parity.

3. Organization Splits

If you split an Organization to move selected users and accounts into a new Org, eligibility rules apply.

  • Whole-Group Moves: If all accounts in a Billing Group move together, the group is reassigned to the new Org with all attributes intact.
  • Partial Moves: If only some accounts move, a new Billing Group is created in the destination Org for those accounts, which will then revert to the default pricing model.

 

 

Safeguards: The "Split" and "Pending" Errors

To prevent invalid billing configurations, the system enforces strict "guardrails". If an operation violates these, you will see one of the following errors:

Error CodeMeaningRequired Action
SPLIT_REQUIREDYou are trying to move only one account out of a group that contains many.You must contact Support to unlink the account into its own singleton group first.
PENDING_ASSOCIATIONThe account is currently in the middle of a Multi-Account Invoicing (MAI) setup.You must wait until the month-end process completes or contact Support to cancel the pending setup.

Note: If an account is unlinked from a group during remediation, it will fall back to its "default" billing configuration and pricing.

Have more questions? Submit a request
Powered by Zendesk