Menu

Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

REST API: Accounts

When you first sign up with Twilio, you have just one account, your Master 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

auth_token

The authorization token for this account. This token should be kept a secret, so no sharing.

date_created
date_time<rfc2822> Not PII

The date that this account was created, in GMT in RFC 2822 format

date_updated
date_time<rfc2822> Not PII

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
sid<AC> Not PII

The unique 34 character id that represents the parent of this account. The OwnerAccountSid of a parent account is it's own sid.

sid
sid<AC> Not PII

A 34 character string that uniquely identifies this resource.

status
enum:status Not PII

The status of this account. Usually active, but can be suspended or closed.

subresource_uris
uri_map Not PII

A Map of various subresources available for the given Account Instance

type
enum:type Not PII

The type of this account. Either Trial or Full if it's been upgraded

uri
uri Not PII

The URI for this resource, relative to https://api.twilio.com

Create an Account resource

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.

Parameters
FriendlyName
Optional
post string Not PII

A human readable description of the account to create, defaults to SubAccount Created at {YYYY-MM-DD HH:MM meridian}

Example
Loading Code Sample...
      
      
      
      

      Fetch an Account resource

      get
      https://api.twilio.com/2010-04-01/Accounts/{Sid}.json

      Returns a representation of an account, including the properties above.

      Parameters
      Sid
      Required
      get sid<AC> Not PII

      The Account Sid that uniquely identifies the account to fetch

      Example
      Loading Code Sample...
          
          
          
          

          Read multiple Account resources

          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 info on paging refer to the Twilio's response documentation

          Parameters
          FriendlyName
          Optional
          get string Not PII

          Only return the Account resources with friendly names that exactly match this name.

          Status
          Optional
          get ienum:status Not PII

          Only return Account resources with the given status. Can be closed, suspended or active.

          Example 1
          Loading Code Sample...
              
              
              
              
              Example 2
              Loading Code Sample...
                  
                  
                  
                  

                  Update an Account resource

                  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.

                  Parameters
                  FriendlyName
                  Optional
                  post string Not PII

                  Update the human-readable description of this Account

                  Status
                  Optional
                  post ienum:status Not PII

                  Alter the status of this account: use closed to irreversibly close this account, suspended to temporarily suspend it, or active to reactivate it.

                  Example 1
                  Loading Code Sample...
                      
                      
                      
                      
                      Example 2
                      Loading Code Sample...
                          
                          
                          
                          
                          Example 3
                          Loading Code Sample...
                              
                              
                              
                              

                              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 browsing the Twilio tag on Stack Overflow.

                              Loading Code Sample...