---
title: "Changes to Create or refresh an OAuth access token"
method: POST
path: "/oauth/token"
---

# Changes to Create or refresh an OAuth access token

`POST /oauth/token`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 55 revisions.

- **2025-10-02** `83dc2757b74e`: 1 info
- **2025-07-16** `bb819dcb75b3`: 1 breaking, 1 info
- **2025-06-03** `b7200537f765`: 2 breaking, 2 info
- **2025-05-19** `02e6d58e95e9`: 3 breaking, 2 info
- **2025-05-01** `89dcf373f0a2`: 1 info
- **2024-02-21** `5de70cc1e6ca`: 1 breaking

## Changes

- **2025-10-02** `83dc2757b74e`: 1 info
  - added the new `urn:plaid:params:credit:multi-user` enum value to the request property `subject_token_type`
- **2025-07-16** `bb819dcb75b3`: 1 breaking, 1 info
  - removed the enum value `urn:plaid:params:tokensdb:user-token` of the request property `subject_token_type`
  - added the new `urn:plaid:params:tokens:user` enum value to the request property `subject_token_type`
- **2025-06-03** `b7200537f765`: 2 breaking, 2 info
  - removed the enum value `urn:plaid:params:oauth::user-token` of the request property `subject_token_type`
  - removed the enum value `urn:plaid:params:tokensdb::user-token` of the request property `subject_token_type`
  - added the new `urn:plaid:params:oauth:user-token` enum value to the request property `subject_token_type`
  - added the new `urn:plaid:params:tokensdb:user-token` enum value to the request property `subject_token_type`
- **2025-05-19** `02e6d58e95e9`: 3 breaking, 2 info
  - the response property `error` became optional for the status `default`
  - the response property `error_description` became optional for the status `default`
  - the response property `error_uri` became optional for the status `default`
  - added the new optional request property `secret`
  - added the new `client_credentials` enum value to the request property `grant_type`
- **2025-05-01** `89dcf373f0a2`: 1 info
  - endpoint added
- **2024-02-21** `5de70cc1e6ca`: 1 breaking
  - api path removed without deprecation

---

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