When you first sign up with Twilio, you have just one account, your main account. But you can also create more accounts. Subaccounts are useful for things like segmenting phone numbers and usage data for your customers and controlling access to data. For more information on subaccounts, see Using Subaccounts.
auth_token
type: stringThe authorization token for this account. This token should be kept a secret, so no sharing.
date_created
type: string<date-time-rfc-2822>The date that this account was created, in GMT in RFC 2822 format
date_updated
type: string<date-time-rfc-2822>The date that this account was last updated, in GMT in RFC 2822 format.
friendly_name
type: stringA human readable description of this account, up to 64 characters long. By default the FriendlyName is your email address.
owner_account_sid
type: SID<AC>The unique 34 character id that represents the parent of this account. The OwnerAccountSid of a parent account is it's own sid.
^AC[0-9a-fA-F]{32}$
34
34
sid
type: SID<AC>A 34 character string that uniquely identifies this resource.
^AC[0-9a-fA-F]{32}$
34
34
status
type: enum<string>The status of this account. Usually active
, but can be suspended
or closed
.
active
suspended
closed
subresource_uris
type: object<uri-map>A Map of various subresources available for the given Account Instance
type
type: enum<string>The type of this account. Either Trial
or Full
if it's been upgraded
Trial
Full
POST https://api.twilio.com/2010-04-01/Accounts.json
Create a new Account instance resource as a subaccount of the one used to make the request. See Creating Subaccounts for more information.
FriendlyName
type: stringA human readable description of the account to create, defaults to SubAccount Created at {YYYY-MM-DD HH:MM meridian}
GET https://api.twilio.com/2010-04-01/Accounts/{Sid}.json
Returns a representation of an account, including the properties above.
Sid
type: SID<AC>The Account Sid that uniquely identifies the account to fetch
^AC[0-9a-fA-F]{32}$
34
34
GET https://api.twilio.com/2010-04-01/Accounts.json
Read the set of Accounts belonging to the Account used to make the API request. This list includes that account, along with any subaccounts belonging to it.
When fetching multiple pages of API results, use the provided nextpageuri
parameter to retrieve the next page of results. All of the Twilio Helper Libraries use the nextpageuri
to page through resources. For more information on paging, refer to the Twilio's response documentation
FriendlyName
type: stringOnly return the Account resources with friendly names that exactly match this name.
Status
type: enum<string>Only return Account resources with the given status. Can be closed
, suspended
or active
.
active
suspended
closed
PageSize
type: integerHow many resources to return in each list page. The default is 50, and the maximum is 1000.
1
Page
type: integerThe page index. This value is simply for client state.
0
POST https://api.twilio.com/2010-04-01/Accounts/{Sid}.json
Allows you to modify the properties of an account.
See the Subaccounts reference for more information on suspending, unsuspending or closing subaccounts using the 'Status' parameter.
Sid
type: SID<AC>The Account Sid that uniquely identifies the account to update
^AC[0-9a-fA-F]{32}$
34
34
Status
type: enum<string>Alter the status of this account: use closed
to irreversibly close this account, suspended
to temporarily suspend it, or active
to reactivate it.
active
suspended
closed