Pinterest Posting API
A posting API for Pinterest, with the destination board chosen per request.
By André LugPostGate's Pinterest posting API covers the whole workflow with four endpoints: POST /api/profiles/connect to link an account, GET /api/profiles/{id}/boards to list boards, POST /api/posts with a required board_id under post.options.pinterest to create the Pin, and GET /api/posts/{id} to confirm delivery. Each Pin carries one image or one video — no carousels.
“Pinterest posting API” usually means one of two things: Pinterest’s own v5 API, which you’d integrate against directly with your own developer app and access-tier approval, or a managed layer like PostGate that sits in front of it. This page maps the surface PostGate exposes for Pinterest — connection, boards, publishing, and analytics — so you can see what a posting integration actually needs to cover.
Which endpoints cover the whole workflow?
POST /api/profiles/connect, list its boards with GET /api/profiles/{id}/boards, create a Pin with POST /api/posts, and check delivery with GET /api/posts/{id}. The same four shapes are reused for scheduling, deletion, and analytics — there is no separate “Pinterest SDK” to learn.Where do Pinterest-specific fields live?
post.options.pinterest so a multi-platform request doesn’t need to fork into separate payloads per destination. For Pinterest that’s board_id (required) and title (optional).{
"post": {
"body": "Watch the full launch story.",
"options": {
"pinterest": { "board_id": "12345", "title": "Launch story" },
"linkedin": { "visibility": "PUBLIC" }
}
},
"profiles": ["pro_pinterest", "pro_linkedin"]
}What doesn’t this surface do?
delete, stats, and token refresh for Pinterest, but not comments or messages.Why does the access tier behind the connection matter?
Frequently asked questions
What Pinterest-specific fields does a post request need?
Every platform-specific field is namespaced under post.options.pinterest, so a multi-platform request does not need to fork into separate payloads per destination. For Pinterest that is board_id (required) and title (optional).
Can I change a Pin's board after it publishes?
No — there is no editing the destination board after publish. The practical path is deleting the Pin and recreating it on the right board. A Pin is also limited to one image or one video per post, with no carousels.
Does the Pinterest publishing surface include comments or DMs?
No. Comments and DMs are not part of the Pinterest publishing surface. PostGate exposes delete, stats, and token refresh for Pinterest, but not comments or messages.
Do I need my own Pinterest developer app to publish via API?
No. PostGate's shared app already holds Standard access, so a normal connected account publishes real, public Pins immediately. If you bring your own Pinterest developer app instead, that app carries its own access tier and rate limits, and Trial access only creates sandbox Pins visible to the account owner.
