Connect Pinterest to create and schedule Pins, organise boards, track Pin and profile performance, research trends, and run your ad campaigns.
You end up pasting your Pinterest app's App ID and App secret key, both taken from the Api keys section of the Configure tab on developers.pinterest.com/apps.
App review before this connector works
Pinterest must approve your registered app twice: first for Trial access (the app secret is withheld until then), and again for Standard access before Pins and Boards created via the API are visible to anyone but their creator.
- Typical wait
- Pinterest states approvals "typically take one to three business days" for the app/Trial review. Pinterest publishes no timeframe for the Trial-to-Standard upgrade; developers widely report it taking weeks, so treat it as unbounded rather than planning around a number.
- Cost
- Free
- Blocked until approved
- Until the app is approved you cannot even see the client secret, so OAuth cannot be completed and no token exists. Once on Trial access the API works but is rate limited per app per day and everything you create is sandboxed: Pins and Boards are visible only to their creator, so nothing you publish is actually live on Pinterest until Standard access is granted.
- Works meanwhile
- Create the Pinterest business account, register the app and configure redirect URIs. After Trial approval you can build and test the entire OAuth flow, read account data, and create Pins/Boards for real, they are just creator-only until Standard lands.
Where to apply: Register the app at developers.pinterest.com under My apps (business account required); Pinterest reviews it automatically for Trial access. For Standard, open the same apps dashboard, pick the app and select Upgrade, then submit the app description, privacy policy URL and a screen-recorded video of the OAuth flow plus a real API call.
- Standard access is refused without a video recording of your app completing an action through the API, and Pinterest requires it even when you are the only intended user of the integration.
- You must hold Trial access and comply with the Developer Guidelines before a Standard request will be considered; applying straight for Standard fails.
- A live, reachable privacy policy URL and an app description that matches what the video actually shows are checked; mismatches get requests bounced.
- Pinterest does not commit to a turnaround for the Standard upgrade, and developers frequently report requests sitting for weeks; the only remedy is a Help Center ticket under Pinterest API and Developer Tools.
- Pinterest requires a business account, not a personal one, for the developer app.
- Setup time
- 10 min, plus up to one business day for Pinterest to approve trial access
- Auth
- OAuth authorization
- API base URL
- https://api.pinterest.com/v5
- Rate limits
- Trial access applies daily limits per app based on the rate limit category of each endpoint, and ads write calls sit in a lower bucket than reads. Standard access switches to per-minute limits per user per app.
Before you begin
- A Pinterest business account with a verified email address
- Developer Terms of Service accepted on the My apps page
- Trial access approved by Pinterest, which is reviewed each business day
- A live privacy policy URL and a specific app description, since vague descriptions are the most common reason trial access is denied
- Standard access if you need Pins and boards created through the API to be publicly visible rather than sandbox-only
Get your credentials
Sign in as a business account and accept the Developer Terms
Sign in at developers.pinterest.com with a Pinterest business account and confirm the account email address. Open My apps in the top nav and accept the Developer Terms of Service when prompted.
Request trial access with Connect app
On the My apps page click Connect app. Fill in the app name, the app description and your privacy policy URL, then click Submit.
My apps
Apps connected to your Pinterest business account.
No apps yet
Connect an app to request trial access.
Pinterest reviews trial access requests each business day and emails you the outcome.
Add the PopMCP callback as a redirect URI
Once the app is approved, click Manage on the app card and open the Configure tab. Scroll to Redirect URIs, paste the callback URL from the PopMCP connect screen and click Add.
PopMCP Integration
Approved 4 Mar 2026
| App | Access tier | Status |
|---|---|---|
| PopMCP IntegrationApp ID 1602314 | Trial access | Active |
Several redirect URIs are allowed. Pinterest matches each one exactly, so a trailing slash counts as a different URI.
Copy the App ID and App secret key
Stay on the Configure tab and find the Api keys section. Copy the App ID and the App secret key into PopMCP's App ID and App secret fields.
PopMCP Integration
Api keys and scopes
- App ID
- 1602314
- App secret key
- pina_****4a2f
Reset app secret issues a replacement and invalidates the old one immediately.
Upgrade to Standard access when you go live
Open My apps and click Upgrade on the app card. Attach the screen recording of your OAuth flow when the form asks for it.
Connect in PopMCP
Open your workspace, choose Pinterest in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| App IDtext | Your Pinterest app's "App ID" from developers.pinterest.com/apps. Add the callback URL above to that app's redirect URIs first. |
| App secretsecret | The app's secret token (same page as the App ID). Stored encrypted; used server-side only and never shown again.Encrypted with AES-256-GCM on save and never shown again. |
https://app.popmcp.com/api/providers/pinterest/callbackOnly needed if you connect with your own Pinterest app: add this exact URL to that app's "Redirect URIs" (developers.pinterest.com/apps → your app). It must match character for character or Pinterest rejects the authorization.
PopMCP verifies the credential against Pinterest immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Permissions PopMCP requests
These are the scopes sent to Pinterest at authorization time.
| Scope | Why PopMCP asks for it |
|---|---|
| user_accounts:read | Required by the tools this connector exposes. |
| user_accounts:write | Required by the tools this connector exposes. |
| boards:read | Lists the boards a Pin can be saved to. |
| boards:write | Required by the tools this connector exposes. |
| boards:read_secret | Adds secret boards to the board list. Omit it if you never touch private boards. |
| boards:write_secret | Required by the tools this connector exposes. |
| pins:read | Required by the tools this connector exposes. |
| pins:write | Required to create, edit and delete Pins. |
| pins:read_secret | Required by the tools this connector exposes. |
| pins:write_secret | Required by the tools this connector exposes. |
| catalogs:read | Required by the tools this connector exposes. |
| catalogs:write | Only needed if you manage product feeds. Skip it for organic publishing. |
| ads:read | Reads campaigns, ad groups and reporting for the ad tools. |
| ads:write | Creates and edits campaigns. On Trial access this is throttled harder than other scopes. |
| billing:read | Required by the tools this connector exposes. |
| billing:write | Required by the tools this connector exposes. |
| biz_access:read | Required by the tools this connector exposes. |
| biz_access:write | Required by the tools this connector exposes. |
Verify it worked
PopMCP shows the Pinterest connector as Connected with your Pinterest username and account type, and a test call to list boards returns your boards instead of an authorization error.
Troubleshooting
The Api keys section is empty or there is no Manage button
Why: The app is still pending trial access review, so it has no Active status yet.
Fix: Wait for the approval email, which arrives on a business-day cycle, then reload developers.pinterest.com/apps and click Manage.
The app secret key is masked and cannot be revealed again
Why: Pinterest shows the secret once, at the moment it is generated.
Fix: Open Configure, click Reset app secret, confirm with Reset, then copy the new key straight into PopMCP.
invalid_request: redirect_uri mismatch during authorization
Why: The redirect URI in the app profile differs from the callback PopMCP sends, often by a trailing slash or http versus https.
Fix: Copy the callback URL straight from the PopMCP connect screen into Configure, Redirect URIs, and delete any near-duplicate entries.
Trial access request denied
Why: Pinterest most often rejects a missing or unreachable privacy policy URL, or an app description too vague to review.
Fix: Publish a real privacy policy, rewrite the description to name the endpoints you call and why, then resubmit Connect app.
Pins created through PopMCP are not visible on the public profile
Why: The app is on Trial access, where created Pins and boards are sandbox entities visible only to their creator.
Fix: Click Upgrade on the app card in My apps and include a recording of the OAuth flow.
429 Too Many Requests early in the day
Why: Trial access uses a per-app daily budget rather than a per-minute one.
Fix: Check the x-ratelimit-remaining response header, batch your reads, and upgrade to Standard access for per-minute limits.