v29

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-06-042661,1122.5 MB
oauth

Generate OAuth access token

Generate a new OAuth access token using an authorization code; or refresh an existing one using a continuous refresh token.

Follow the complete steps for requesting and refreshing tokens.

Note: If your app was created before September 25, 2025, make sure to set the continuous_refresh parameter to true to use the continuous refresh token (60-day expiration, refreshable indefinitely). Pinterest no longer supports the legacy refresh token (365-day expiration, hard limit).

Disregard this note if your app was activated on or after September 25, 2025. You are automatically using the continuous refresh token.

Use Token Debugger to validate and inspect your access token.

post/oauth/token

Response

The request has succeeded.

access_tokenstring required
expires_ininteger required
refresh_tokenstring
refresh_token_expires_atinteger
refresh_token_expires_ininteger
response_type'authorization_code' | 'refresh_token' | 'client_credentials'

The type of OAuth grant being requested.

scopestring
token_typestring required