---
title: "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."
method: POST
path: "/v1/AuthTokens/Promote"
tags: ["AccountsV1AuthTokenPromotion"]
---

# 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.

`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

- **2026-08-11** (v1) `7f489a631e1b` — 1 info
  - added optional request body
- **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-service-production.skmtc.workers.dev/v1/apis/twilio/accounts-v1/revisions/7f489a631e1b/schema)