Pinterest OAuth setup · OAuth Field Guide

Reviewed

pinterest.comSourcedUpdated 27 Oct 2026 · 2 days ago

Pinterest reviews your app twice. It approves a Trial request before you get credentials, and Trial limits Pins and boards you create to sandbox visibility under daily rate limits. For production you need Standard access, which takes a second review of a demo video showing your OAuth flow and a live API call.

Your work: 3–8 h
Waiting on Pinterest: Unknown
First user connects: After Pinterest approves your Trial request, which developers report takes from about 3 days to over 3 weeks

4 not confirmed 12 sources Why this tier How did it go?

.md JSON

Use with your agent

Set up a Pinterest OAuth app for our integration, as far as you can.
Guide: https://oauth-guide.akshatsethi.com/apps/pinterest.md (updated 27 Oct 2026)

Reviewed. Hands-on work: 3–8 h. Waiting on Pinterest: unknown.

Check these exist first:
- Pinterest business account [human]
- Public privacy policy on your company domain [human]
- Publicly accessible website [human]

Needed later, not now:
- Demo video of the OAuth flow (for launch)

Steps, in order:
1. [human] Sign in and accept the Developer Terms
2. [agent] Fill in the Connect app form. On My apps, choose Connect app and describe your app, use case and privacy policy URL. The app name needs at least 3 Latin letters or digits and can't contain "Pinterest". Watch out: Vague descriptions and privacy policy URLs off your company domain are the most common reasons Trial is denied or the form is rejected.
3. [human] Submit the Trial access request
4. [provider] Wait for Trial approval (wait 3–21 days)
5. [agent] Add your redirect URI. In My apps, choose Manage, open the Configure tab, enter your redirect URI under Redirect URIs, and select Add. It must match the redirect_uri you send exactly and must not redirect again. Watch out: A mismatched trailing slash or protocol is the most common cause of authentication failures.
6. [human] Configure your OAuth client
7. [agent] Test a connection with your own account. Run the OAuth flow with your business account and make a real API call. Under Trial, Pins and boards you create are sandbox entities visible only to you.
8. [human] Record the demo video
9. [human] Submit the Standard access upgrade
10. [provider] Wait for the Standard access decision (wait unknown)

Rules:
- Do [agent] steps yourself. Steps in Pinterest's dashboard need a browser I'm signed in to; without one, give me the exact clicks and values instead, then carry on with the code.
- At each [human] or [provider] step, stop and tell me exactly what's needed.
- Never put client secrets in chat, code or commits. I paste them into our OAuth client or secret manager myself.
- Request the narrowest scopes that work. Ask me before choosing scopes or changing security settings (scope restrictions, roles, grant types), even where the guide marks the step [agent].
- Claims marked Inferred or low confidence in the guide are unverified. Check them and tell me what you find.
- If the guide doesn't match what you see (a page, field or requirement), tell me and report it so it gets fixed: POST https://oauth-guide.akshatsethi.com/api/reports with {"app": "pinterest", "step": 2, "message": "what you saw"} (step is optional), or call the report_problem MCP tool. Never put secrets or personal data in a report.
- When setup ends (users can connect, or it's waiting on Pinterest's review) or you can't get past a step, report how it went so the guide improves: POST https://oauth-guide.akshatsethi.com/api/reports with {"app": "pinterest", "outcome": "worked" | "waiting" | "stuck", "step": 3, "message": "what happened"}, or call the report_setup MCP tool. Stopping for me at a [human] step isn't stuck: don't report that.
- Finish with what's done, the redirect URI and scopes used, and what's left before public launch.

Paste into Claude Code, Cursor or any agent.

Pinterest

Plan

SetupBefore you start

BuildTrial access

LaunchStandard access

Why reviewed

Scopes

When you get stuck

Not confirmed

Sources

Feedback

Pinterest

Plan

SetupBefore you start

BuildTrial access

LaunchStandard access

Why reviewed

Scopes

When you get stuck

Not confirmed

Sources

Feedback