Subaccount status

Twilio allows you to suspend, close or re-activate a subaccount.

Suspending a subaccount

While an account is suspended it cannot make or receive phone calls or send and receive SMS messages. This is useful when your customer does not pay their bill, and you want to suspend their account until a successful payment is received. However, you will be charged monthly for any phone numbers the subaccount owns.

To suspend a subaccount, update the Status property with the value suspended to suspend an account.

📘

NOTE

Note that in-progress calls will not automatically end when a subaccount is suspended. This must be done manually by changing the status of these calls to completed.

❗️

WARNING

You must use your main account's authentication credentials to suspend a subaccount. Also, you cannot suspend your main account.

Closing a subaccount

You can permanently close a Twilio subaccount by updating the Status property with the value closed

When you close a subaccount, Twilio will release all phone numbers assigned to it and shut it down completely. You can't ever use a closed account to make and receive phone calls or send and receive SMS messages. It's closed, gone, kaput - you cannot reopen a closed account.

Your closed subaccount will still appear in your accounts list, and you will still have access to historical data for that subaccount, unless automatic deletion of closed subaccounts is enabled.

If you have enabled automatic deletion of closed subaccounts through the Subaccounts settings page, we will delete all subaccount data 30 days after closure, including previously closed subaccounts and they will no longer appear on the Console.

Twilio has enabled this setting for all accounts created after July 5, 2018, and for all accounts without subaccounts
For all other accounts, account owners can turn this setting on through the Subaccounts settings page.

Re-activate a suspended subaccount

To re-activate a suspended account, update the Status property to active.