Rate this page:

REST API: Auth Token

Twilio uses the Account SID and Auth Token to authenticate API requests. The Auth Token can be rotated in the Console or with this API. There are two related endpoints, one to create or delete the secondary Auth Token and this one to promote the secondary Auth Token.

Auth Token properties

Resource Properties in REST API format
sid<AC> Not PII

The SID of the Account that the secondary Auth Token was created for.


The promoted Auth Token that must be used to authenticate future API requests.

date_time<iso8601> Not PII

The date and time in UTC when the resource was created specified in ISO 8601 format.

date_time<iso8601> Not PII

The date and time in GMT when the resource was last updated specified in ISO 8601 format.

url Not PII

The URI for this resource, relative to

Update an AuthTokenPromotion resource


This action will delete the current primary Auth Token, promote the secondary Auth Token to primary.

Example 1
Loading Code Sample...

        Promote the Secondary Auth Token

        Rate this page:

        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.

        Loading Code Sample...

              Thank you for your feedback!

              Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

              Sending your feedback...
              🎉 Thank you for your feedback!
              Something went wrong. Please try again.

              Thanks for your feedback!