Pinterest Posting API: Create & Schedule Pins with Board, Title and Link
No waiting on Pinterest's trial-access review and no board IDs to keep track of. Create and schedule Pins with a destination link from your app, an AI agent or n8n, using one API key.
Free plan · 2 accounts · No credit card · API + MCP included
- Image Pins
- Multi-image Pins (up to 5)
- Video Pins
- Board selection
- Pin title
- Destination link
- Scheduled Pins
Last updated 28 October 2026. The Pinterest Trial access, a 1,000-request daily limit and a 90-day analytics window below are stated as of that date.
Reviewed by Attila Kun, Technical Co-founder. Last updated 28 October 2026.
What is the Pinterest Posting API?
The Pinterest Posting API is a part of the official Pinterest v5 API. It allows apps to create Pins on a board over open REST, there's no partner program required. All new apps start in the Trial access: this allows you to publish your own content only, along with 1,000 requests a day. If you want standard access, it requires a video demo of your OAuth flow.
WoopSocial helps you use the Pinterest posting API without the trial-access review or the frustrating board-ID bookkeeping. It also adds scheduling and drafts, so you can plan Pins ahead of time. This is because WoopSocial already has access, meaning you can connect a Pinterest account and start enjoying these right away - plus it's free for up to 2 accounts.
WoopSocial vs the Pinterest API
| Pinterest API v5 direct | |
|---|---|
| Trial access (your own account, 1,000 requests a day) until a video-demo review | Already on production access |
| Look up board IDs before every Pin | GET /social-accounts/{id}/platform-inputs lists your boards |
| Build your own scheduler | Scheduling and drafts built in |
| A 90-day window for organic analytics | Post analytics snapshots you can store over time |
Three steps to automated Pinterest posting
Step 1
Connect your account
Send yourself, or your own users, a hosted connect link and they approve access in a few clicks. WoopSocial stores and refreshes the tokens, so that's one less thing for you to worry about.
Step 2
Create the post
Send one request describing the Pin - the Pinterest account, the board, a title, your image or video, a destination link and when it should go out. To find the board, call GET /social-accounts/{id}/platform-inputs, which lists the account's boards with their IDs and names. Use SCHEDULE_FOR_LATER with a UTC timestamp to queue it.
Step 3
We handle the rest
WoopSocial uploads your media and publishes the Pin at the allocated time. Temporary errors are retried automatically and webhooks notify your app when a Pin is posted or fails, so there's no scheduler for you to build or host.
Everything you need to ship Pinterest features
Board, title & link as fields
Choose the board, set the title and add the destination URL - up to 2,048 characters.
Seasonal scheduling, weeks ahead
Plan recipes and gift guides ahead. You can schedule Pins to your preferred date and time in UTC, or save drafts.
The same image on Instagram, with different copy
Send one image to Pinterest and Instagram in one request, with a different caption for each using contentOverride.
Pin analytics
Get impressions, saves and clicks for each Pin. Measure your performance with our Pinterest engagement calculator.
Free Pinterest tools
Name your boards with the Pinterest board name generator and size your images with the Pinterest image resizer.
Three ways in
- REST.
- MCP. Example prompt: “Pin this to my Recipes board, link it to the blog post, and schedule it Sunday 9am”
- Agent pages: /muse/pinterest, /grok/pinterest.
- No-code: n8n, Zapier, Make.
1 · Account
Create a free WoopSocial account
Sign up at app.woopsocial.com/signup (no credit card). You'll authorize through OAuth when the agent connects — no API key required for MCP.
2 · Pinterest
Connect your account
Link a Pinterest account in the WoopSocial dashboard before you ask an agent to pin. No trial-access review on your side.
3 · Agent
Add the MCP URL and authorize
Use
https://api.woopsocial.com/mcp. Your client opens OAuth — approve access and you're connected. Docs: Integrating MCP clients.
Install by client
Pick your agent. Cards marked On this site open another WoopSocial page; External opens outside this site (new tab).
Social Media MCP
On this siteStep-by-step install for Claude, ChatGPT and any MCP client, with screenshots.
Open page →
Claude
External1-click: add the WoopSocial connector from Claude's directory and authorize with OAuth.
Open external link →
ChatGPT
On this siteEnable Developer Mode, add the MCP URL, authorize with OAuth, then test in chat.
Open page →
Cursor
External1-click: install the WoopSocial plugin from Cursor Directory, then schedule Pins from the agent.
Open external link →
Muse
On this siteLet Muse create and schedule Pins, with the board, title and destination link handled.
Open page →
Grok
On this siteWoopSocial’s connector lets Grok create and schedule Pins in plain language, with the board, title and destination link handled for you.
Open page →
MCP scheduling guide
On this siteCopy-paste prompts and setup for Claude, ChatGPT and Cursor.
Open page →
Config for Cursor / other MCP clients
Prefer 1-click? Install the WoopSocial Cursor plugin. Or paste this into .cursor/mcp.json (or your client's MCP config). Authorize with OAuth when prompted — no API key in the URL. Allowlist *.cloudflarestorage.com if media uploads are blocked.
{
"mcpServers": {
"woopsocial": {
"url": "https://api.woopsocial.com/mcp"
}
}
}Claude Code
One command registers the remote HTTP MCP server. Complete OAuth when prompted.
claude mcp add --transport http woopsocial "https://api.woopsocial.com/mcp"After install — try this
Plain-language Pinterest prompt
You
Pin this to my Recipes board, link it to the blog post, and schedule it Sunday 9am
Prefer a full walkthrough with screenshots? Start at /social-media-mcp.
One POST /posts call with a board, title, destination link and image or video. Same shape as every other platform.
curl https://api.woopsocial.com/v1/social-accounts/YOUR_PINTEREST_ACCOUNT_ID/platform-inputs \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X POST https://api.woopsocial.com/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": [{
"text": "Sunday soup, on the table in 30 minutes.",
"media": [{ "type": "MEDIA_LIBRARY", "mediaId": "MEDIA_ID" }]
}],
"schedule": {
"type": "SCHEDULE_FOR_LATER",
"scheduledFor": "2026-07-05T09:00:00Z"
},
"socialAccounts": [{
"platform": "PINTEREST",
"socialAccountId": "YOUR_PINTEREST_ACCOUNT_ID",
"pinterestBoardId": "BOARD_ID",
"title": "Sunday soup",
"link": "https://example.com/sunday-soup"
}]
}'All three open external partner sites in a new tab.
REST API example: schedule a Pin
List the account's boards, then send the same POST /posts call with a board, title, destination link and UTC time. Authorization header and request body included.
curl https://api.woopsocial.com/v1/social-accounts/YOUR_PINTEREST_ACCOUNT_ID/platform-inputs \
-H "Authorization: Bearer YOUR_API_KEY"
curl -X POST https://api.woopsocial.com/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"content": [{
"text": "Sunday soup, on the table in 30 minutes.",
"media": [{ "type": "MEDIA_LIBRARY", "mediaId": "MEDIA_ID" }]
}],
"schedule": {
"type": "SCHEDULE_FOR_LATER",
"scheduledFor": "2026-07-05T09:00:00Z"
},
"socialAccounts": [{
"platform": "PINTEREST",
"socialAccountId": "YOUR_PINTEREST_ACCOUNT_ID",
"pinterestBoardId": "BOARD_ID",
"title": "Sunday soup",
"link": "https://example.com/sunday-soup"
}]
}'Prefer a calendar? Schedule Pins from the dashboard
If you're someone that prefers to plan Pins on a calendar than in code, the WoopSocial dashboard has you covered. Schedule Pinterest Pins for any date, and at any time, well in advance. Link multiple Pinterest accounts and work through them side by side - perfect for agencies and those managing multiple brands.
AI captions are available and are a good plus. Using cross-posting, you can send the same image to Instagram as well from the same screen. Cross-posting sends the same image to Instagram from the same screen. The dashboard runs on the same backend as the API, so a Pin your team schedules in the calendar behaves exactly like one your code creates. The free plan includes 2 accounts and needs no credit card.
Schedule from the dashboard
Pinterest requirements & limits
Account type
A Pinterest Business account is recommended, and some analytics need one, so switch before you connect if you need performance reports.
Text limits
A Pin title can be up to 100 characters, the description up to 800, and the alt text up to 500.
Link
The destination link can be up to 2,048 characters long.
Images
The recommended image ratio is 2:3, or 1000 by 1500 pixels. Our Pinterest image resizer helps you get your image to that size quickly.
Video and multi-image Pins
Video Pins run from 4 seconds to 15 minutes. Multi-image Pins take 2 to 5 images, and a single Pin can't mix images and video.
FAQ
Can I schedule Pinterest Pins via API?
Do I need a board ID?
Can I add a destination link and title?
Do I need Pinterest Standard access?
Can I post video Pins or multi-image Pins?
Does it include Pinterest analytics?
How many Pinterest accounts can I connect?
Can AI agents create Pins?
Does this require a Pinterest Business account?
Can I set a Pin description and alt text?
Can I delete a Pin I have scheduled?
Learn more
Each card opens another page on this site.
Pinterest engagement calculator
On this siteCalculate your Pinterest engagement rate with our free calculator.
Open page →
Post to Pinterest with Grok
On this siteWoopSocial's connector lets Grok create and schedule Pins in plain language, with the board, title and destination link handled for you.
Open page →
How to schedule social media posts with MCP
On this siteA step-by-step setup for Claude, ChatGPT and Cursor, with copy-paste prompts.
Open page →
Start posting to Pinterest today
“I connected WoopSocial's MCP to my AI agents, now I can post directly to all my social channels with just one command. Whenever I finish some website work or wrote a new blog post, I simply tell the AI agent to post it directly to my social media channels via WoopSocial. The content generation and bulk scheduling via the web app is also very useful. The time I spent managing social media has been reduced drastically. Gamechanger!”
Connect a Pinterest account, grab a free API key and schedule your first Pin in minutes. No trial-access review, no credit card.
Free plan · 2 accounts · No credit card · API + MCP included