---
title: "Changes to Generate OAuth access token"
method: POST
path: "/oauth/token"
---

# Changes to Generate OAuth access token

`POST /oauth/token`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 29 revisions.

- **2026-06-04** (v5) `b698c180678a`: 2 breaking, 24 info
- **2025-07-16** (v5) `43134ca41f18`: 1 info
- **2024-08-14** (v5) `89c27ed39cfd`: 1 warning, 3 info
- **2024-02-08** (v5) `7529b464d5cb`: 1 info
- **2023-02-14** (v5) `be19b77aa78a`: 1 info
- **2022-09-07** (v5) `bd20b6eb152f`: 1 info

## Changes

- **2026-06-04** (v5) `b698c180678a`: 2 breaking, 24 info
  - the response property `scope` became optional for the status `200`
  - the `response_type` response's property type changed from `string` to no type for status `200`
  - added the new optional request property `code`
  - added the new optional request property `continuous_refresh`
  - added the new optional request property `redirect_uri`
  - added the new optional request property `refresh_token`
  - added the new optional request property `scope`
  - removed request discriminator
  - removed response discriminator for the response status `200`
  - added the non-success response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `429`
  - added the optional property `refresh_token` to the response with the `200` status
  - added the optional property `refresh_token_expires_at` to the response with the `200` status
  - added the optional property `refresh_token_expires_in` to the response with the `200` status
  - the response optional property `response_type` became read-only for the status `200`
  - added `#/components/schemas/TokenGrantType` to the `response_type` response property `allOf` list for the response status `200`
  - removed the `authorization_code` enum value from the `response_type` response property for the response status `200`
  - removed the `client_credentials` enum value from the `response_type` response property for the response status `200`
  - removed the `refresh_token` enum value from the `response_type` response property for the response status `200`
  - the response required property `access_token` became read-only for the status `200`
  - the response required property `expires_in` became read-only for the status `200`
  - the response required property `token_type` became read-only for the status `200`
  - added the success response with the status `201`
- **2025-07-16** (v5) `43134ca41f18`: 1 info
  - removed `everlasting_refresh` mapping keys from the response discriminator for the response status `200`
- **2024-08-14** (v5) `89c27ed39cfd`: 1 warning, 3 info
  - added the new `client_credentials` enum value to the `response_type` response property for the response status `200`
  - added `client_credentials` mapping keys to the request discriminator
  - added the new `client_credentials` enum value to the request property `grant_type`
  - added `client_credentials` mapping keys to the response discriminator for the response status `200`
- **2024-02-08** (v5) `7529b464d5cb`: 1 info
  - added `everlasting_refresh` mapping keys to the response discriminator for the response status `200`
- **2023-02-14** (v5) `be19b77aa78a`: 1 info
  - added `integration_refresh` mapping keys to the response discriminator for the response status `200`
- **2022-09-07** (v5) `bd20b6eb152f`: 1 info
  - the endpoint scheme security `basic` was added to the API

---

[Operation](https://skmtc.dev/pinterest/apis/pinterest-rest-api/docs/oauth/token/post.md) - [API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) - [Page](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/oauth/token/post)