{"slug":"pinterest","name":"Pinterest","domain":"pinterest.com","category":"Social media","summary":"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.","tier":"reviewed","tierReason":"You only get an app secret after Pinterest manually approves Trial access, and you need a second, video-based review for Standard access before real users can use it in production.","quality":"researched","updatedAt":"2026-10-27","composio":{"status":"managed","note":"Composio lists Pinterest under Composio-managed OAuth, so you can prototype without waiting for Pinterest's Trial review. Register your own app before launch so your name is on the consent screen and you control your own access tier.","toolkit":"pinterest"},"totals":{"effort":{"min":3,"max":8,"unit":"hours"},"wait":null,"firstConnection":"After Pinterest approves your Trial request, which developers report takes from about 3 days to over 3 weeks"},"stages":[{"id":"build","name":"Trial access","whoCanConnect":"Your own Pinterest business account. Whether other accounts can authorize a Trial app isn't documented.","userSees":"Pinterest's standard OAuth consent page. Pins and boards created under Trial are visible only to their creator, as sandbox entities.","effort":{"min":1,"max":3,"unit":"hours"},"wait":{"min":3,"max":21,"unit":"days"},"unlock":"Submit an upgrade request with a demo video and get Standard access approved.","evidence":{"kind":"docs","sources":["s1","s2","s5","s9"],"confidence":"medium"}},{"id":"launch","name":"Standard access","whoCanConnect":"Any Pinterest user. For apps registered on or after 2026-09-14, reading Pins or boards the authorizing account doesn't own needs separate Pinner data approval.","userSees":"Pinterest's OAuth consent page. Created content is visible normally, and rate limits are per minute, per user and per app.","effort":{"min":2,"max":5,"unit":"hours"},"wait":null,"unlock":null,"evidence":{"kind":"docs","sources":["s2","s3","s6"],"confidence":"high"}}],"requirements":[{"id":"business-account","label":"Pinterest business account","detail":"You administer the app from a business account with a verified email address. Apps linked to personal accounts disappear from the portal until you convert the account.","stage":"build","actor":"you","evidence":{"kind":"docs","sources":["s1","s7"],"confidence":"high"}},{"id":"privacy-policy","label":"Public privacy policy on your company domain","detail":"The privacy policy URL must be live, public and describe your app, and it must be on your company's domain. Otherwise the form rejects it with a company-name error.","stage":"build","actor":"you","evidence":{"kind":"docs","sources":["s2","s4","s8"],"confidence":"high"}},{"id":"public-site","label":"Publicly accessible website","detail":"Pinterest staff list a public site as a prerequisite for Trial access.","stage":"build","actor":"you","evidence":{"kind":"community","sources":["s4"],"confidence":"medium"}},{"id":"demo-video","label":"Demo video of the OAuth flow","detail":"The video shows a user starting the connection in your app, Pinterest sign-in and consent, the return to your redirect URI, and a successful live API call. Terminal or Postman recordings are accepted.","stage":"launch","actor":"you","evidence":{"kind":"docs","sources":["s2","s5"],"confidence":"high"}}],"steps":[{"id":"accept-terms","title":"Sign in and accept the Developer Terms","actor":"you","stage":"build","time":{"min":5,"max":20,"unit":"minutes"},"detail":"Sign in with your business account and verify its email address. Then open My apps and accept the Developer Terms of Service.","actions":["Create or convert to a Pinterest business account","Verify the account's email address","Open https://developers.pinterest.com/apps/ and accept the Developer Terms"],"agentNote":"A person must sign in and accept the terms. After that, an agent can fill in the app form.","gotcha":"Apps owned by a personal account stop appearing in the portal.","link":{"label":"My apps","url":"https://developers.pinterest.com/apps/"},"evidence":{"kind":"docs","sources":["s1","s7"],"confidence":"high"}},{"id":"connect-app","title":"Fill in the Connect app form","actor":"agent","stage":"build","time":{"min":15,"max":45,"unit":"minutes"},"detail":"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\".","actions":["Select Connect app","Enter the app name, a specific description and the use case","Enter a privacy policy URL on your company domain"],"agentNote":"An agent can fill in the form. Hand back to the person to submit it.","gotcha":"Vague descriptions and privacy policy URLs off your company domain are the most common reasons Trial is denied or the form is rejected.","link":{"label":"My apps","url":"https://developers.pinterest.com/apps/"},"image":{"url":"https://i.pinimg.com/originals/e4/98/6e/e4986eb1bdb46c112f33a67ab8945990.png","alt":"My apps page with Connect app","source":"s1"},"evidence":{"kind":"docs","sources":["s1","s2","s8"],"confidence":"high"}},{"id":"submit-trial","title":"Submit the Trial access request","actor":"you","stage":"build","time":{"min":2,"max":5,"unit":"minutes"},"detail":"Submit the form to request Trial access. Pinterest emails you with its decision.","gotcha":"Denied requests have been reported to lock the app fields with no way to resubmit. If that happens, open a Help Center ticket.","evidence":{"kind":"docs","sources":["s1"],"confidence":"high"}},{"id":"wait-trial","title":"Wait for Trial approval","actor":"provider","stage":"build","time":{"min":3,"max":21,"unit":"days"},"detail":"Pinterest publishes no turnaround time. Forum reports range from a few days to more than three weeks, and the app secret stays locked until approval.","gotcha":"Staff send pending-review questions to a known-issue support article instead of answering in the thread.","evidence":{"kind":"community","sources":["s9","s10"],"confidence":"low"}},{"id":"redirect-uri","title":"Add your redirect URI","actor":"agent","stage":"build","time":{"min":5,"max":10,"unit":"minutes"},"detail":"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.","actions":["My apps > Manage > Configure","Redirect URIs: paste your redirect URI","Select Add"],"agentNote":"An agent can do this. A person copies the app secret into your OAuth client.","gotcha":"A mismatched trailing slash or protocol is the most common cause of authentication failures.","link":{"label":"My apps","url":"https://developers.pinterest.com/apps/"},"image":{"url":"https://i.pinimg.com/originals/2d/e2/38/2de2385546de5e98ae5c62f5acffb4c3.png","alt":"Redirect URIs section on the Configure tab","source":"s1"},"evidence":{"kind":"docs","sources":["s1","s5"],"confidence":"high"}},{"id":"configure-client","title":"Configure your OAuth client","actor":"you","stage":"build","time":{"min":15,"max":45,"unit":"minutes"},"detail":"Copy the app ID and app secret into your OAuth client. Use https://www.pinterest.com/oauth/ to authorize, https://api.pinterest.com/v5/oauth/token to get tokens with HTTP Basic auth, and scopes such as boards:read and pins:write. Access tokens last 30 days, and refresh tokens last 60 days but renew continuously.","actions":["Authorize URL: https://www.pinterest.com/oauth/ (response_type=code)","Token URL: https://api.pinterest.com/v5/oauth/token","Request only the scopes you need","Refresh tokens before they expire"],"agentNote":"An agent can enter the endpoint URLs and scopes. A person handles the app secret.","gotcha":"Apps created before 2025-09-25 must pass continuous_refresh=true.","evidence":{"kind":"docs","sources":["s3"],"confidence":"high"}},{"id":"test-connection","title":"Test a connection with your own account","actor":"agent","stage":"build","time":{"min":10,"max":30,"unit":"minutes"},"detail":"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.","agentNote":"An agent can run the flow once a person is signed in to Pinterest.","evidence":{"kind":"docs","sources":["s2","s6"],"confidence":"high"}},{"id":"record-demo","title":"Record the demo video","actor":"you","stage":"launch","time":{"min":1,"max":3,"unit":"hours"},"detail":"Record a user starting the Pinterest connection in your app, signing in and approving, returning to your redirect URI, and completing a live API action.","gotcha":"Slides, mockups, generic product tours and demos without OAuth get denied.","evidence":{"kind":"docs","sources":["s2","s5"],"confidence":"high"}},{"id":"submit-upgrade","title":"Submit the Standard access upgrade","actor":"you","stage":"launch","time":{"min":10,"max":20,"unit":"minutes"},"detail":"On the app card in My apps, choose Upgrade. Verify the app info and privacy policy, upload the video and submit.","gotcha":"The Upgrade button appears only on apps that already have Trial access.","link":{"label":"My apps","url":"https://developers.pinterest.com/apps/"},"evidence":{"kind":"docs","sources":["s2"],"confidence":"high"}},{"id":"wait-standard","title":"Wait for the Standard access decision","actor":"provider","stage":"launch","time":null,"detail":"Pinterest says it reviews upgrade requests regularly and emails you its decision. It gives no timeframe. To appeal a denial, use a Help Center ticket.","evidence":{"kind":"docs","sources":["s2"],"confidence":"high"}}],"scopes":{"intro":"Scopes use the {entity}:read or {entity}:write form. Pinterest doesn't classify them into review tiers, but newly registered apps need extra approval to read other people's Pins and boards.","tiers":[{"scope":"boards:read, pins:read, user_accounts:read","grants":"Read the authorizing user's boards, Pins and profile","level":"basic","consequence":"Nothing beyond the Trial and Standard reviews."},{"scope":"boards:write, pins:write","grants":"Create and edit boards and Pins","level":"basic","consequence":"Created content is sandbox-only until you have Standard access."},{"scope":"boards:read_secret, pins:read_secret (and write_secret)","grants":"Access to secret boards and Pins","level":"sensitive","consequence":"No separate review is documented. Request these only if you need them."},{"scope":"Pinner data access (not a scope)","grants":"Reading Pins and boards the authorizing account doesn't own","level":"restricted","consequence":"Apps registered on or after 2026-09-14 get 403 PINNER_DATA_ACCESS_DENIED unless Pinterest approves access through an account manager."}]},"blockers":[{"symptom":"\"Please include your company name in the URL for your privacy policy\" when creating the app","cause":"The privacy policy URL must be on your company's domain, and the check is strict.","fix":"Host the policy on your own company domain. If it still fails, contact Pinterest support by private ticket or DM, because the usual ticket form needs an App ID.","evidence":{"kind":"community","sources":["s4","s8"],"confidence":"medium"}},{"symptom":"App stuck in \"Trial access pending\" with the app secret locked","cause":"Manual review backlog with no published turnaround time.","fix":"Follow the community's known-issue article for pending Trial requests and file a Help Center ticket that includes your App ID.","evidence":{"kind":"community","sources":["s9","s10"],"confidence":"medium"}},{"symptom":"HTTP 403 PINNER_DATA_ACCESS_DENIED when reading a board or Pin","cause":"Apps registered on or after 2026-09-14 can only read the authorizing account's own Pins and boards without extra approval.","fix":"Read only the authorizing user's own data, or ask your Pinterest account manager for Pinner data access. Don't retry in a loop.","evidence":{"kind":"docs","sources":["s3","s6"],"confidence":"high"}},{"symptom":"Pins created through the API aren't visible to anyone else","cause":"Under Trial access, Pins and boards are sandbox entities visible only to their creator.","fix":"Upgrade to Standard access.","evidence":{"kind":"docs","sources":["s2"],"confidence":"high"}}],"unknowns":[{"question":"Can Pinterest accounts other than yours authorize an app that only has Trial access?","why":"The access-tier, sandbox and FAQ pages don't say.","resolve":"After Trial approval, try the OAuth flow with a second business account, or ask in the Pinterest Business Community."},{"question":"How long does Standard access review take?","why":"Pinterest only says requests are reviewed regularly, and I found no dated reports from developers.","resolve":"Search community.pinterest.biz for recent upgrade-pending threads."},{"question":"What are the exact Trial rate limits?","why":"The docs say only that limits are daily per app. A third-party guide claims 1,000 requests per day, but no official source confirms it.","resolve":"Check the rate limits page on developers.pinterest.com or the response headers after you get Trial access."},{"question":"How do apps without an account manager get Pinner data access?","why":"The docs only point you to an account manager.","resolve":"Ask Pinterest developer support through the Help Center."}],"handoff":{"agentCan":["Fill in the Connect app form once you're signed in","Add your redirect URI on the Configure tab","Enter the authorize and token URLs and scopes in your OAuth client","Run a test connection with your signed-in account"],"youMust":["Create or convert to a Pinterest business account and verify its email","Accept the Developer Terms","Host a privacy policy on your company domain","Submit the Trial request and the Standard upgrade","Copy the app secret into your OAuth client","Record the demo video","Contact Pinterest about stuck reviews or Pinner data access"]},"sources":[{"id":"s1","title":"Getting started","url":"https://developers.pinterest.com/docs/getting-started/","publisher":"Pinterest Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s2","title":"Understanding our access tiers","url":"https://developers.pinterest.com/docs/key-concepts/access-tiers/","publisher":"Pinterest Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s3","title":"Set up authentication and authorization","url":"https://developers.pinterest.com/docs/getting-started/set-up-authentication-and-authorization/","publisher":"Pinterest Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s4","title":"Getting Started with your Pinterest Developer App: Trial Access","url":"https://community.pinterest.biz/t/getting-started-with-your-pinterest-developer-app-trial-access/52222.md","publisher":"Pinterest Business Community","kind":"community","checkedAt":"2026-10-27"},{"id":"s5","title":"Standard Access Walkthrough, a Step by Step Guide","url":"https://community.pinterest.biz/t/standard-access-walkthrough-a-step-by-step-guide/52518.md","publisher":"Pinterest Business Community","kind":"community","checkedAt":"2026-10-27"},{"id":"s6","title":"Understanding the Pinner_Data_Access_Denied Access Error","url":"https://community.pinterest.biz/t/understanding-the-pinner-data-access-denied-access-error/51738","publisher":"Pinterest Business Community","kind":"search","checkedAt":null},{"id":"s7","title":"Frequently Asked Questions: Pinterest API","url":"https://community.pinterest.biz/t/frequently-asked-questions-pinterest-api/2083.md","publisher":"Pinterest Business Community","kind":"community","checkedAt":"2026-10-27"},{"id":"s8","title":"Privacy policy URL rejected on app creation despite valid, live URL","url":"https://community.pinterest.biz/t/privacy-policy-url-rejected-on-app-creation-despite-valid-live-url/48979","publisher":"Pinterest Business Community","kind":"search","checkedAt":null},{"id":"s9","title":"Trial access pending since August 25","url":"https://community.pinterest.biz/t/trial-access-pending-since-august-25/50394.md","publisher":"Pinterest Business Community","kind":"community","checkedAt":"2026-10-27"},{"id":"s10","title":"Trial access request pending 20+ days","url":"https://community.pinterest.biz/t/trial-access-request-pending-20-days-app-id-1591546/49284","publisher":"Pinterest Business Community","kind":"search","checkedAt":null},{"id":"s11","title":"Sandbox","url":"https://developers.pinterest.com/docs/developer-tools/sandbox/","publisher":"Pinterest Developers","kind":"official","checkedAt":"2026-10-27"},{"id":"s12","title":"Composio managed auth toolkits","url":"https://docs.composio.dev/toolkits/managed-auth.md","publisher":"Composio docs","kind":"composio","checkedAt":"2026-10-27"}],"feedback":{}}