Does Pinterest have an API?
Yes. Pinterest's v5 API covers pins and boards, and SocialAPI.ai exposes it through the same REST API as every other platform, so you create a pin with the same request you use to post to Instagram or LinkedIn.
The Pinterest API for pins and boards
Publish pins, list and manage boards, and read back pin metrics through the same unified API you already use for every other platform. Connect an account once through OAuth, name a board on the target, and the rest of your publishing code is untouched. Pinterest has no comments, DMs or mentions to read: it is a publishing surface, and this page says so plainly rather than implying an inbox that does not exist.
Free tier available
Instant API key
MCP server included
See it in action.
Create a pin on Pinterest
api.social-api.ai
1# 1. List the account's boards to pick a target
2curl https://api.social-api.ai/v1/accounts/<pinterest-account-id>/boards \
3 -H "Authorization: Bearer <your-api-key>" | jq
4
5# 2. Create the pin on one of them
6curl -X POST https://api.social-api.ai/v1/posts \
7 -H "Authorization: Bearer <your-api-key>" \
8 -H "Content-Type: application/json" \
9 -d '{
10 "title": "Weeknight roast chicken",
11 "text": "One pan, forty minutes, no marinade.",
12 "targets": [{
13 "account_id": "<pinterest-account-id>",
14 "board_id": "<board-id>",
15 "media": [{ "source_type": "url", "source": "https://example.com/chicken.jpg", "type": "image" }]
16 }]
17 }' | jq
The same POST /v1/posts endpoint you already use for every other platform. A Pinterest target names the board the pin lands on and carries exactly one image.
What you can do with Pinterest.
Supported
Publishing
Create pins through the same POST /v1/posts call as every other platform. Each target names a board and carries one image.
Supported
Boards
List, create, rename and delete boards through /v1/accounts/:id/boards. Boards are fetched live from Pinterest on every read, never cached.
Good to know.
A pin needs a board and an image. There is no default board and no text-only pin: every Pinterest target carries a board_id and one image, and a draft missing either is rejected before it reaches Pinterest.
Published pins cannot be edited. Pinterest's edit endpoint is still in their own beta, and pin media is immutable in any case, so changing a pin means deleting it and creating a new one, which mints a new pin id.
Pinterest has no comments, DMs, mentions or reviews in its public API, so those endpoints return 501 for a Pinterest account rather than an empty list. The inbox is genuinely empty for this platform, and the 501 says so outright.
Pinterest sends no webhooks of its own. Publish results still reach your webhook endpoint because those events are ours, but nothing arrives when someone interacts with a pin on Pinterest.
Deleting a board deletes every pin on it, and Pinterest does not undo that. The API surfaces the call; the consequences are Pinterest's.
Platform throttling surfaces as a 429 and does not consume your SocialAPI.ai quota. Retry with backoff rather than treating it as a failed write.
Why developers love Pinterest on SocialAPI.ai
1
Pins through the endpoint you already call
A Pinterest pin goes out through the same POST /v1/posts request as Instagram, LinkedIn or Threads. The target names a board and carries one image, the post title becomes the pin title and the text becomes its description. Scheduling, retries and the publish webhook work exactly as they do everywhere else, because those are ours rather than Pinterest's.
2
Boards as a first-class resource
List, create, rename and delete boards through /v1/accounts/:id/boards without writing a line of Pinterest-specific HTTP. Every read goes live to Pinterest rather than to a cache of ours, so the board list you get is the board list the account actually has, including a board someone created in the Pinterest app a second ago.
3
We never store your Pinterest data
Pinterest's Developer Terms forbid storing information accessed through their API, so we do not: boards are fetched on every call and kept only for the length of the request. There is no cache to go stale, no sync job to fall behind, and nothing of yours sitting in our database waiting to be wrong.
4
One schema, one set of error codes
Pins come back in the same unified post schema as every other platform and fail with the same HTTP sentinels: 401 for a dead credential, 429 when Pinterest throttles you, 501 for something Pinterest does not support. Pinterest is a new target for code you have already written, not a second integration to maintain.
5
Token refresh handled for you
Pinterest access tokens expire after thirty days and refresh tokens after sixty. We refresh in the background before expiry and keep the account live, so a connection made once keeps working without a reconnect prompt appearing in front of your user.
Simple, honest pricing.
Reading comments, DMs, and mentions is free and unlimited on every plan. Paid plans start at $29/mo with unlimited posts and interactions. The free tier needs no credit card.
FAQ
Frequently asked questions.
Can I publish pins through the API?
Yes. Send a POST /v1/posts request with a Pinterest account in the targets array, a board_id on that target, and one image. The post title becomes the pin title and the text becomes its description.
Can I read or reply to comments on my pins?
No. Pinterest's public API exposes no comment endpoints, so there is nothing for us to read. Those calls return 501 for a Pinterest account rather than pretending the inbox is empty. If you need comment moderation today, Instagram, Facebook, YouTube, TikTok, Threads, X, Bluesky and LinkedIn all support it through the same endpoints.
How do I manage Pinterest boards?
Through /v1/accounts/:id/boards: list, create, rename and delete. Every read goes live to Pinterest rather than to a cache, because Pinterest's Developer Terms forbid storing what you fetch from their API.
How do I connect a Pinterest account?
Through OAuth, once per account, the same flow as every other platform. You do not need your own Pinterest developer app: the connection runs through SocialAPI.ai's, and we refresh the token in the background before it expires.
Can I edit a pin after publishing it?
No. Pinterest's edit endpoint is still in their own beta and pin media is immutable regardless, so changing a published pin means deleting it and creating a new one. The new pin gets a new id.
Can AI agents create pins?
Yes. The built-in MCP server exposes publishing and board management as tools, so Claude and other MCP-capable agents can draft pins and pick boards inside your existing approval flow.
Get started today
Ready to unify your social interactions?
Free tier available · No credit card required · Ships with MCP server