Pinterest Posting API
Create Pins on any board with a title, description, link and alt text, straight from your app.
- Pins with title, description, link and alt text
- Pick the board per Pin
- Accounts connect through Pinterest's login
- Limits and a log per key
const pk = new Postkey(process.env.POSTKEY_KEY);
await pk.posts.create({
accounts: [
"acc_pin_987"
],
content: "A small-space desk setup that actually works",
media: [
{
type: "image",
url: "https://cdn.example.com/desk.jpg"
}
],
pinterest: {
boardId: "board_5521",
title: "Small-space desk setup",
link: "https://example.com/desk-setup",
altText: "Wooden desk with a monitor arm in a narrow room"
}
});- Pinterestpublished
1 call · key customer_42
Your first Pinterest post in three steps
- 1
Connect Pinterest
Your customer signs in through Pinterest's own login. You get an account ID, never a password.
- 2
Make a key
Create a key for that customer or agent, scoped to their accounts, with the caps you choose.
- 3
Post
Send the post to /v1/posts with that key. The Pinterest result comes back in the response and by webhook.
Every Pinterest format, one endpoint
Pick a format to see the exact request and what comes back. Options that only make sense on Pinterest sit under "pinterest".
An image Pin on a board, linking back to your page.
1POST https://api.postkey.dev/v1/posts2Authorization: Bearer pk_cust_42_…3Content-Type: application/json4 5{6 "accounts": [7 "acc_pin_987"8 ],9 "content": "A small-space desk setup that actually works",10 "media": [11 {12 "type": "image",13 "url": "https://cdn.example.com/desk.jpg"14 }15 ],16 "pinterest": {17 "boardId": "board_5521",18 "title": "Small-space desk setup",19 "link": "https://example.com/desk-setup",20 "altText": "Wooden desk with a monitor arm in a narrow room"21 }22}200 · published
Counted against customer_42 only.
{
"id": "post_3k9d2",
"status": "published",
"results": [
{
"account": "acc_pin_987",
"platform": "pinterest",
"status": "published",
"url": "https://www.pinterest.com/pin/…"
}
]
}Everything you need for Pinterest posting
Checked against Pinterest's rules
Before anything is sent, Postkey checks it against Pinterest's published limits:
Board per Pin
Every Pin lands on a board. Pass the board ID and Postkey checks the account can save to it.
Links that send traffic
Each Pin can link to a page. That's most of why people post to Pinterest from an app.
Alt text
Send alt text with the image so the Pin is readable with a screen reader.
Pinterest login
Accounts connect through Pinterest's own login. You never handle a password.
Caps per key
An agent writing Pins from a product feed can only make as many as its key allows.
Also for Pinterest
Keys & control
Every Pinterest post has an owner
Each customer or agent posts to Pinterest through its own key: only its accounts, its own caps, its own log, and an off switch that touches nothing else.
Works with your stack
Your code
Node and Python SDKs with the same calls, or plain REST from anything that speaks HTTP.
- Node
- Python
- {}REST
No-code tools
Call the REST API from an HTTP step in n8n, Make or Zapier. Give each workflow its own key.
- n8n
- Make
- Zapier
AI agents & MCP
The MCP server lets Claude, Cursor and other agent tools post through their own key, with caps they can't change.
- MCP server
Beyond Pinterest
Same request shape on every platform. Add an account ID and the post goes there too.
- X Posting APIText · Image · Video · Thread
- Instagram Posting APIFeed post · Reel · Story · Carousel
- Facebook Posting APIText · Photo · Video
- TikTok Posting APIVideo · Photo
- LinkedIn Posting APIText · Image · Document
- YouTube Posting APIVideo
- YouTube Shorts Posting APIShort
- You're herePinterest Posting APIPin
- Google Business Posting APIUpdate post · Offer · Event
Pinterest posting questions
Something not here? Email hello@postkey.dev.
What can I post to Pinterest?
Image Pins with a title, description, destination link and alt text, saved to a board you choose.
Do I need a board ID?
Yes. Pinterest saves every Pin to a board. Postkey lists the boards for a connected account so you can pick one.
Can a Pin link to my site?
Yes. Set link and the Pin sends people to that page.
Are title and description checked?
Yes, against Pinterest's published limits listed above, before the Pin is sent.
Can I post to Pinterest and Instagram together?
Yes. List both account IDs in one request. Each gets its own result.
Can I schedule Pinterest posts instead?
Yes. Add scheduledFor to the same request. See the Pinterest Scheduling API page for details.
Post to Pinterest with a key per customer.
Get a key, connect an account, send the request above.
Free to start. Read the docs