---
title: "Exchanges a Teams Phone token for an ACS user access token."
method: POST
path: "/access/teamsExtension/:exchangeAccessToken"
tags: ["TeamsExtension"]
---

# Exchanges a Teams Phone token for an ACS user access token.

`POST /access/teamsExtension/:exchangeAccessToken`

Exchanges a Teams Phone token for an ACS user access token.

## Query parameters

- `api-version` string, required

## Request body

- TeamsExtensionExchangeTokenRequest — A request to exchange a Teams Extension token.

## Response `200`

The request has succeeded.

- CommunicationIdentityAccessTokenResult — A communication identity with access token.
  - `identity` CommunicationIdentity, required — A communication identity.
    - `id` string, required — Identifier of the identity.
  - `accessToken` CommunicationIdentityAccessToken — An access token.
    - `token` string, required — The access token issued for the identity.
    - `expiresOn` string, date-time, required — The expiry time of the token.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** `6f165034a0c4` — 1 info
  - api operation id `TeamsExtensionToken_Exchange` removed and replaced with `TeamsExtensionOperations_ExchangeToken`
- **2026-07-13** `04b250b803d8` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/communication-identity/changes/access/teamsExtension/:exchangeAccessToken/post.md)

---

[API](https://skmtc.dev/azure/apis/communication-identity.md) · [All operations](https://skmtc.dev/azure/apis/communication-identity/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/communication-identity/revisions/6f165034a0c4/schema)