Subaccount Status

This endpoint allows you to update or change the status of a subaccount.

Suspend a Subaccount

When a subaccount is suspended, it cannot make or receive calls or SMS messages, which is helpful for accounts with unpaid bills. However, you'll still incur monthly charges for any phone numbers owned by the subaccount. To suspend a subaccount, send a POST request with the parameter 'Status' set to 'suspended.'

👍

Important 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.

To reactivate a suspended subaccount, POST the value active for the Status parameter and we will restore the account to full service.

👍

Important Note

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

Close a Subaccount

To permanently close a subaccount, send a parameter 'Status' with the value closed to the subaccount resource URI.

Twilio release all phone numbers assign closed subaccounts and shut down completely, preventing phone calls or SMS messages.

Closed subaccounts still appear in the accounts list and historical data can be accessed unless automatic deletion is enabled. This setting is enabled for accounts created after July 5, 2018, and accounts without subaccounts.

👍

Important Note

Note that you must use your main account's authentication credentials to close a subaccount. You also cannot close your main account.

Language
Credentials
Basic
base64
:
Response
Click Try It! to start a request and see the response here!