---
title: "POST /v1/AuthTokens/Promote"
method: POST
path: "/v1/AuthTokens/Promote"
tags: ["AccountsV1AuthTokenPromotion"]
---

# POST /v1/AuthTokens/Promote

`POST /v1/AuthTokens/Promote`

Promote the secondary Auth Token to primary. After promoting the new token, all requests to Twilio using your old primary Auth Token will result in an error.

## Response `200`

OK

- AccountsV1AuthTokenPromotion
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the secondary Auth Token was created for.
  - `auth_token` string, nullable — The promoted Auth Token that must be used to authenticate future API requests.
  - `date_created` string, date-time, nullable — The date and time in UTC when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `url` string, uri, nullable — The URI for this resource, relative to `https://accounts.twilio.com`

## Changes

- **2023-08-10** (v1) `ec5af6efe634` — 1 info
  - api tag `AccountsV1AuthTokenPromotion` added

[Change history](https://skmtc.dev/twilio/apis/accounts-v1/changes/v1/AuthTokens/Promote/post.md)

---

[API](https://skmtc.dev/twilio/apis/accounts-v1.md) · [All operations](https://skmtc.dev/twilio/apis/accounts-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/accounts-v1/revisions/290f2e1dcabb?raw)