---
title: "Generate OAuth access token"
method: POST
path: "/oauth/token"
tags: ["oauth"]
---

# Generate OAuth access token

`POST /oauth/token`

Generate an OAuth access token by using an authorization code or a refresh token.

IMPORTANT: You need to start the OAuth flow via www.pinterest.com/oauth before calling this endpoint (or have an existing refresh token).

See <a href='/docs/getting-started/authentication-and-scopes/'>Authentication</a> for more.

<strong>Parameter <i>refresh_on</i> and its corresponding response type <i>everlasting_refresh</i> are now available to all apps! Later this year, continuous refresh will become the default behavior (ie you will no longer need to send this parameter). <a href='/docs/getting-started/using-beta-and-restricted-features/'>Learn more</a>.</strong>

<strong>Use <a href='/tools/debug-token/'>Token Debugger</a> to validate and inspect your access token.</strong>

## Response `200`

response

- OauthAccessTokenResponse — A successful OAuth access token response.
  - `response_type` 'authorization_code' | 'refresh_token' | 'client_credentials'
  - `access_token` string, required
  - `token_type` string, required
  - `expires_in` integer, required
  - `scope` string, required

## Other responses

- `default` — Unexpected error

## Changes

- **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

[Change history](https://skmtc.dev/pinterest/apis/pinterest-rest-api/changes/oauth/token/post.md)

---

[API](https://skmtc.dev/pinterest/apis/pinterest-rest-api.md) · [All operations](https://skmtc.dev/pinterest/apis/pinterest-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinterest/pinterest-rest-api/revisions/7d64d863909a/schema)