Pinterest

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

SEND FROMYour appAI agentn8n / ZapierPOST /v1/posts · PINTEREST← published · 86 savesWoopSocialProduction accessLook up boardRecipesTitle + linkblog postScheduleSun 09:00PublishPin liverecipesPinterestPIN000webhook + analytics
  • 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

Comparison of the Pinterest API v5 direct versus WoopSocial for posting
Pinterest API v5 directWoopSocial
Trial access (your own account, 1,000 requests a day) until a video-demo reviewAlready on production access
Look up board IDs before every PinGET /social-accounts/{id}/platform-inputs lists your boards
Build your own schedulerScheduling and drafts built in
A 90-day window for organic analyticsPost analytics snapshots you can store over time

Three steps to automated Pinterest posting

  1. 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.

  2. 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.

  3. 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. 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. 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. 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).

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.

json
{
  "mcpServers": {
    "woopsocial": {
      "url": "https://api.woopsocial.com/mcp"
    }
  }
}

Claude Code

One command registers the remote HTTP MCP server. Complete OAuth when prompted.

bash
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.

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.

bash
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
WoopSocial calendar for scheduling Pins

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.

Cross-post the same visual

Instagram (same visual), Facebook.

FAQ

Can I schedule Pinterest Pins via API?

Yes. Set SCHEDULE_FOR_LATER with a UTC timestamp and WoopSocial publishes the Pin at that time. You can also save the Pin as a draft.

Do I need a board ID?

Yes, each Pin needs one. WoopSocial can list your boards without the IDs - GET /social-accounts/{id}/platform-inputs returns the name and id of every board, and you send the ID as pinterestBoardId. In the dashboard, or with an AI agent, you just select the board.

Can I add a destination link and title?

Yes. Each Pin takes a title and a destination link as their own fields, with the link allowed up to 2,048 characters.

Do I need Pinterest Standard access?

No. Pinterest apps start in Trial access, restricted to your own content and 1,000 requests per day. Standard access requires a video demo of your OAuth flow. WoopSocial has existing production access so you can connect an account and publish without requiring that review.

Can I post video Pins or multi-image Pins?

Yes. You can publish image Pins, video Pins or carousel Pins (up to 5 images each) and alt text is supported. You cannot include both images and videos in one Pin. If your image aspect ratios differ, validation will give you a warning and WoopSocial will normalize them prior to publication.

Does it include Pinterest analytics?

Yes. Every Pin returns an impression, save and click. Pinterest allows 90 days of analytics within their organic analytics, and WoopSocial's post analytics snapshots allow you to store the results over time. You can also see the analytics of your accounts including followers.

How many Pinterest accounts can I connect?

Your plan determines the account count - 2 on Free, 20 on Pro, 100 on Business and 2,500 on Max.

Can AI agents create Pins?

Yes. WoopSocial's MCP server works in Claude, ChatGPT and Cursor, so you can ask an assistant to pin an image to a board and schedule it in plain language. Our guide to scheduling social media posts with MCP covers the setup.

Does this require a Pinterest Business account?

It does, it is recommended that you have a business account. Some analytics actually require one, so it's smart to switch before you connect if you want to get performance reports.

Can I set a Pin description and alt text?

Yes, you can. Descriptions can be up to 800 characters, while the alt text has a limit of 500 characters.

Can I delete a Pin I have scheduled?

Yes, you can. A pin that is scheduled can be deleted before it publishes on your account.

Post to more than Pinterest

Same API key. Same request format. Same across all the networks listed below. One integration for all of these networks.

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!”

Chris

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