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

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

`POST /v1/token`

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

## Response `201`

Created

- OauthV1Token
  - `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

## Changes

- **2024-04-04** (v1) `7f3f4b21ff81` — 1 info
  - the endpoint scheme security `accountSid_authToken` was removed from the API
- **2024-04-01** (v1) `e0385b93e66b` — 1 breaking, 3 info
  - the `expires_in` response's property type/format changed from `string`/`date-time` to `integer`/`int64` for status `201`
  - added the new optional request property `RefreshToken`
  - added the new optional request property `Scope`
  - the request property `ClientSecret` became optional
- **2024-03-14** (v1) `5fa9155efe92` — 2 breaking, 7 warning, 4 info
  - added the new required request property `ClientId`
  - the request property `ClientSecret` became required
  - removed the request property `ClientSid`
  - removed the request property `CodeVerifier`
  - …9 more
- **2023-08-10** (v1) `69cec05717a0` — 1 info
  - api tag `OauthV1Token` added

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

---

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