---
title: "Exchange an Entra ID access token of a Teams user for a new Communication Identity access token with a matching expiration time."
method: POST
path: "/teamsUser/:exchangeAccessToken"
tags: ["TeamsUser"]
---

# Exchange an Entra ID access token of a Teams user for a new Communication Identity access token with a matching expiration time.

`POST /teamsUser/:exchangeAccessToken`

Exchange an Entra ID access token of a Teams user for a new Communication Identity access token with a matching expiration time.

## Query parameters

- `api-version` string, required

## Request body

- TeamsUserExchangeTokenRequest — A request to exchange a Teams user access token.
  - `token` string, required — Entra ID access token of a Teams User to acquire a new Communication Identity access token.
  - `appId` string, required — Client ID of an Entra ID application to be verified against the appid claim in the Entra ID access token.
  - `userId` string, required — Object ID of an Entra ID user (Teams User) to be verified against the oid claim in the Entra ID access token.

## Response `200`

The request has succeeded.

- 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 `CommunicationIdentity_ExchangeTeamsUserAccessToken` removed and replaced with `TeamsUserOperations_ExchangeTeamsUserAccessToken`
- **2026-07-13** `d090b2de0052` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/communication-identity/changes/teamsUser/: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)