REST API: Accounts
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.
Account properties
| Resource Properties in REST API format | |
|---|---|
auth_token
|
The authorization token for this account. This token should be kept a secret, so no sharing. |
date_created
|
The date that this account was created, in GMT in RFC 2822 format |
date_updated
|
The date that this account was last updated, in GMT in RFC 2822 format. |
friendly_name
|
A human readable description of this account, up to 64 characters long. By default the FriendlyName is your email address. |
owner_account_sid
|
The unique 34 character id that represents the parent of this account. The OwnerAccountSid of a parent account is it's own sid. |
sid
|
A 34 character string that uniquely identifies this resource. |
status
|
The status of this account. Usually |
subresource_uris
|
A Map of various subresources available for the given Account Instance |
type
|
The type of this account. Either |
uri
|
The URI for this resource, relative to |
Create an Account resource
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.
Parameters
| Parameters in REST API format | |
|---|---|
friendly_name
Optional
|
A human readable description of the account to create, defaults to |
Example 1
Fetch an Account resource
https://api.twilio.com/2010-04-01/Accounts/{Sid}.json
Returns a representation of an account, including the properties above.
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Account Sid that uniquely identifies the account to fetch |
Example 1
Read multiple Account resources
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 info on paging refer to the Twilio's response documentation
Parameters
| Parameters in REST API format | |
|---|---|
friendly_name
Optional
|
Only return the Account resources with friendly names that exactly match this name. |
status
Optional
|
Only return Account resources with the given status. Can be |
Example 1
Example 2
Update an Account resource
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.
Parameters
| Parameters in REST API format | |
|---|---|
sid
Path
|
The Account Sid that uniquely identifies the account to update |
friendly_name
Optional
|
Update the human-readable description of this Account |
status
Optional
|
Alter the status of this account: use |
Example 1
Example 2
Example 3
Need some help?
We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.
