---
title: "Issues a new Access token (optionally identity_token & refresh_token) in exchange of Oauth grant"
method: POST
path: "/v2/token"
tags: ["OauthV2Token"]
---

# Issues a new Access token (optionally identity_token & refresh_token) in exchange of Oauth grant

`POST /v2/token`

## Query parameters

- `account_sid` string

## Response `200`

Created

- V2Oauth2TokenResponse
  - `access_token` string, nullable — Token which carries the necessary information to access a Twilio resource directly.
  - `refresh_token` string, nullable — Token which carries the information necessary to get a new access token.
  - `id_token` string, nullable — Token which carries the information necessary of user profile.
  - `token_type` string, nullable — Token type
  - `expires_in` integer, nullable

## Other responses

- `400` — Client provided invalid parameters response
- `500` — Generic error response

## Changes

> 12 revisions in range; 2 could not be searched.

- **2025-12-03** (v2) `1729dd773371` — 1 info
  - added the new optional `query` request parameter `account_sid`
- **2025-09-25** (v2) `f21bbe869ebd` — 2 info
  - the request property `client_id` became optional
  - the request property `grant_type` became optional

[Change history](https://skmtc.dev/twilio/apis/oauth-v2/changes/v2/token/post.md)

---

[API](https://skmtc.dev/twilio/apis/oauth-v2.md) · [All operations](https://skmtc.dev/twilio/apis/oauth-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/oauth-v2/revisions/58dc8223e536/schema)