OAuth providers
Set up Pinterest OAuth for boards, pins, and visual content management
Overview
Section titled “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
Section titled “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.
Step 2: Add to Alter Vault
Section titled “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
Section titled “Available Scopes”| Scope | Description |
|---|---|
boards:read | Read board data |
boards:write | Create and manage boards |
pins:read | Read pin data |
pins:write | Create and manage pins |
user_accounts:read | Read user account data |
ads:read | Read advertising data |
ads:write | Create and manage ads |
catalogs:read | Read product catalogs |
catalogs:write | Manage product catalogs |
- Some scopes (e.g.,
ads:read) require the application to be approved for advertising access. - See the Pinterest OAuth documentation for more details.