Pinterest

Overview

Connect your users to Pinterest for board management, pin creation, audience insights, and advertising data.

Property	Value
Provider ID	pinterest
Category	Social
PKCE	Supported
Token refresh	Automatic
Redirect URI	Shown in Developer Portal

Step 1: Create a Pinterest OAuth App

Sign in to the Pinterest Developer Portal

Navigate to developers.pinterest.com/apps and sign in with a Pinterest business account. Personal accounts cannot register apps.

Accept the Developer Terms of Service

Open My apps and accept the Developer Terms of Service.

Connect a new app

Click Connect app, complete the request form with the app information, and submit for trial access. Pinterest reviews requests each business day.

Configure the redirect URI

Once approved, open My apps, click Manage on the app, and on the Configure tab add the Alter callback URL from the Developer Portal to the Redirect URIs section. The redirect URI must match exactly during OAuth authorization.

Get credentials

Copy the App ID (Client ID) and App secret key (Client Secret) from the app details page.

Warning

Never share the application Secret Key publicly. Store it securely and only enter it in the Alter Vault Developer Portal.

Step 2: Add to Alter Vault

Open the Developer Portal

Go to portal.alterauth.com and navigate to the application.

Add Pinterest provider

Go to OAuth Providers > Add Provider > Pinterest.

Enter credentials

• Client ID: Paste your Pinterest App ID
• Client Secret: Paste your Pinterest App Secret Key

Select scopes

Choose the scopes the application needs.

Save

Click Save. The provider is now active.

Available Scopes

Scope	Description
boards:read	See public boards, including group boards
boards:write	Create, update, or delete public boards
boards:read_secret	See secret boards
boards:write_secret	Create, update, or delete secret boards
pins:read	See public pins
pins:write	Create, update, or delete public pins
pins:read_secret	See secret pins
pins:write_secret	Create, update, or delete secret pins
user_accounts:read	See user accounts and followers
user_accounts:write	Update user accounts and followers
ads:read	See advertising data such as ads, ad groups, and campaigns
ads:write	Create, update, or delete ads, ad groups, and campaigns
catalogs:read	See product catalog data
catalogs:write	Create, update, or delete catalogs
billing:read	See billing data such as the billing profile
billing:write	Create, update, or delete billing data
biz_access:read	See business access data
biz_access:write	Create, update, or delete business access data

Notes

• Some scopes (e.g., ads:read) require the application to be approved for advertising access.
• See the Pinterest OAuth documentation for more details.

Policy-cataloged operations

Alter policy rules can target these attested operations and families for operation-level and parameter-aware controls.

Operation ID	Families	Method	Provider path
pins/create	send, write	POST	/pins
pins/get	read	GET	/pins/{pin_id}
pins/list	read	GET	/pins
pins/update	write	PATCH	/pins/{pin_id}
pins/save	write	POST	/pins/{pin_id}/save
pins/delete	delete	DELETE	/pins/{pin_id}
pins/analytics	read	GET	/pins/{pin_id}/analytics
boards/create	write	POST	/boards
boards/get	read	GET	/boards/{board_id}
boards/list	read	GET	/boards
boards/list_pins	read	GET	/boards/{board_id}/pins
boards/update	write	PATCH	/boards/{board_id}
boards/delete	delete	DELETE	/boards/{board_id}
search_user_pins/list	read	GET	/search/pins
search_user_boards/get	read	GET	/search/boards
user_account/get	read	GET	/user_account
user_account/analytics	read	GET	/user_account/analytics