Pins a new app creates stay visible only to their creator until Pinterest approves Standard access. Pinterest API tiers, scopes, video Pins and limits.
Yes. The v5 API has endpoints to create boards and Pins, and a token with the boards:read, boards:write, pins:read and pins:write scopes. What you can see afterwards depends on your access level.
Why are the Pins my app creates invisible to everyone else?
Pinterest says that boards and Pins created with Trial access are only visible to their creator, as Sandbox entities. Standard access removes that restriction.
How do I get Standard access?
Your app must already have Trial approval and follow the Developer Guidelines. In My apps you select Upgrade, verify your use case and privacy policy link, and upload a video demo that shows the OAuth flow and that you store no sensitive information. Pinterest says requests are reviewed regularly and gives no timeframe.
What are the rate limits?
Pinterest lists 1,000 requests per day for Trial and 100 requests per second per user per app for Standard, with lower limits for some categories. Pinterest also says all rate limits are subject to change without notice.
Can the API publish video Pins?
Yes, in four steps: create a media upload, send the file to the upload URL, wait until the media status is succeeded, then create the Pin with the video_id source and a cover_image_url. Without a valid cover image the API returns a 400 error.
Can an AI agent post to Pinterest?
Yes. It can call the API itself, which means handling the access review and the tokens, or it can use a tool that already holds the connection. Clautia doesn't hold a Pinterest connection yet: Pinterest is coming soon in Clautia.
The Pinterest API lets an app create boards and Pins for a user who authorizes it. The surprise is the starting point: a new app gets Trial access, and everything it creates is visible only to its creator until Pinterest approves Standard access. This guide from Clautia, the agentic social media manager, explains the two levels, the scopes, how a video Pin is made and the limits, using Pinterest's developer documentation, consulted on 9 November 2026. Pinterest updates these pages, so check them before you build.
Trial or Standard: the choice that decides who sees your Pins
Reading and creating; boards and Pins you create are "only visible to their creator as Sandbox entities"
Daily, per app, by category
Standard
Apps that offer Pinterest features to users or run in production
The same activities, with no visibility restriction on created boards and Pins
Higher, per minute, per user, per app
Trial is the default once your app is approved. To get that approval you need a business account with a verified email, you accept the Developer Terms of Service on the My apps page and you register the app. Its name must include at least 3 Latin letters or numbers and cannot contain the word "Pinterest". Pinterest then emails you whether the request was approved or denied. Once approved, you can generate product limited tokens to test without setting up OAuth; they expire after 24 hours (from the set-up guide).
Moving to Standard
The upgrade has requirements and a short procedure, according to the access tiers page:
The app must already be approved for Trial and comply with the Developer Guidelines.
In My apps, select Upgrade on the app card. It only shows for eligible apps.
Verify your use case and your privacy policy link.
Upload a video demo that shows the OAuth authentication flow and that you do not store sensitive information. This applies even if you are the only user, and a recording of a terminal or Postman is accepted.
Submit the request.
Pinterest says requests are "reviewed regularly" and gives no timeframe, and that you get an email when there is a decision. It lists the reasons for denial: the demo does not show the authentication flow, the app uses non-approved authentication such as collecting login credentials or session cookies instead of OAuth, or the demo does not show a live Pinterest integration (wireframes and general platform demos do not count). To appeal, you submit a ticket in the Help Center.
Scopes and what you can create
The guide on creating boards and Pins lists the scopes your token needs: boards:read, boards:write, pins:read and pins:write. It describes the formats this way:
Image and video Pins. Pins are now simplified to those two formats.
Image source.media_source with source_type set to image_url and the url of the image.
Saving existing Pins. Use pins/save for curation, which can save a Pin to multiple boards.
Quantity limits per account. Up to 200,000 Pins and up to 2,000 boards, secret ones included.
The page gives no image size limit, carousel count or text length for titles and descriptions, so check the Create Pin reference for the exact fields before you assume them.
How a video Pin is made
Video takes four calls:
POST /media/create with {"media_type": "video"}. The response has a media_id, an upload_url and upload_parameters.
Send the file (.mp4, .mov or .m4v) to the upload_url as multipart/form-data with all the upload_parameters. No Bearer authentication is needed, and a successful upload returns 204 No Content.
Call GET /v5/media/{media_id} until the status is succeeded.
Create the Pin with source_type: video_id, the media_id and a cover_image_url. Without a valid cover image the API returns 400 Bad Request.
Rate limits
Pinterest's rate limits page sets a universal limit per level, then limits per category:
Scope
Trial
Standard
All API requests
1,000 per day
100 per second per user per app
org_write category
300 per day
100 per minute
org_read category
1,000 per day
1,000 per minute
Each endpoint belongs to one category, shown on its reference page, so look up the category of the Pin endpoints you use. Responses carry headers such as x-ratelimit-limit, x-ratelimit-remaining and x-ratelimit-reset. Pinterest adds that all rate limits are subject to change without notice.
One more date to know. The access tiers page says that for apps registered on or after 14 September 2026, requests for a board or Pin without Pinterest's authorization for non-business users may return HTTP 403 PINNER_DATA_ACCESS_DENIED.
Build the integration or use a tool that holds it
Posting through the API means passing the Trial review, recording the Standard demo and keeping tokens fresh. If you only need to publish your own Pins, that is a lot of setup. Our comparison of social media APIs puts Pinterest next to the other networks, and MCP vs API explains how an agent should reach any of them. The previous guide in the series covers the TikTok API. To start from the account side, read how to create a Pinterest business account and how to post on Pinterest.
Where Clautia fits
Clautia doesn't publish to Pinterest today: Pinterest is coming soon, and the app doesn't offer it as a network to connect yet. Until then, the options are the ones above: build on the API, or publish from Pinterest. The Pinterest scheduling guide shows how to plan pins by season in the meantime.
For the networks Clautia publishes to, an AI agent (Claude Code, Codex, Cursor…) can work through Clautia's MCP server and REST API. It authenticates with your API key in the Authorization header and uses actions such as brands_list, accounts_list, posts_create, posts_schedule, posts_publish, ai_draft and ai_adapt. Posts stay as drafts until someone schedules or publishes them. The API documentation lists the endpoints.
What to remember
A new app has Trial access, and its Pins are visible only to their creator.
Standard needs a video demo of the OAuth flow, and Pinterest gives no review time.
The scopes are boards:read, boards:write, pins:read and pins:write.
A video Pin needs an upload, a status check and a valid cover image.
Rate limits depend on level and category, and can change without notice.