Pinterest API · Image Pins · Video Pins · Carousel Pins

The Pinterest publishing API for developers

Publish image, video, and carousel Pins to Pinterest boards via API. PostPulse owns the platform access, so you ship on day one — no audit, no token plumbing.

Get started free →Read the API docs

No platform audit on your side No tokens to babysit No credit card to test

Numbers from the last 12 months · see live stats →

12+

Pinterest posts shipped

13,581+

Total posts published

across all 10 platforms

Platforms — one API

Native Pinterest API · the actual cost

What you'd build and maintain yourself

Every item below is real friction the native Pinterest API hands you. PostPulse handles all of them.

Standard access review

New Pinterest apps start on Trial access — publishing for real users requires a Standard access review

PostPulse holds Standard access — you skip the review.

Board IDs required

Every Pin must target a board ID, so you have to list each user's boards (and sections) before you can post

List boards with one call; pass the board ID as chatId.

Multi-step video upload

Video Pins are a multi-step flow: register the upload, send the file to a separate upload URL, poll processing status, then create the Pin

Pass a URL or file; PostPulse runs the upload and polling.

Per-format media shapes

Image, video, and carousel Pins each use a different media source shape in the create-Pin request

Same attachmentPaths for image, video, and carousel Pins.

Token refresh per user

OAuth access tokens expire and must be refreshed for every connected user

PostPulse manages OAuth refresh for every account.

Minutes to your first post

Schedule a Pinterest post in two API calls

Import your media, then schedule the post with your Pinterest settings. PostPulse does the rest.

# Step 1: Import media from a public URL
curl -X POST https://api.post-pulse.com/v1/media/upload/import \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://your-cdn.com/media/video.mp4" }'

# Response: { "path": "uuid/video.mp4" }

# Step 2: Schedule a post using the publications array
curl -X POST https://api.post-pulse.com/v1/posts \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "scheduledTime": "2026-06-01T10:00:00Z",
    "isDraft": false,
    "publications": [
      {
        "socialMediaAccountId": 123,
        "platformSettings": { "type": "PINTEREST", "title": "Your Pin title", "link": "https://your-site.com/landing-page" },
        "posts": [
          {
            "content": "Check out our latest content! #developer #api",
            "chatId": "1234567890123456789",
            "attachmentPaths": ["uuid/video.mp4"]
          }
        ]
      }
    ]
  }'

What you ship on day one

What you can build with the Pinterest API

Every capability maps to a real field in the API. Click through for the exact request shape.

Pinterest Video Scheduling

Schedule video posts to publish at a specific future date and time across multiple platforms.

Pinterest Image Posting

Post single images or photo collections to social media platforms via REST API.

Pinterest Carousel

Publish multi-image carousel posts (up to 10 images, depending on the platform) to Instagram, LinkedIn, Facebook, TikTok, Threads, and Pinterest.

Pinterest Scheduling

Schedule any post type — text, image, video, or carousel — to publish at a precise future timestamp.

Pinterest Auto-Publish

Trigger immediate publication to social media platforms from your backend or automation workflow.

Pinterest Media Upload

Upload images and videos via direct binary upload, presigned URL, or remote URL import — then reference the media path in attachmentPaths.

Pinterest Webhooks

Receive real-time webhook events for post completion, failure, and media import status across all platforms.

Pinterest White-Label

Let your users connect their own social accounts via a seamless OAuth flow that never exposes PostPulse branding.

DIY vs PostPulse

The same Pinterest integration, two timelines

Both columns assume you know your stack. Only one has you doing undifferentiated platform plumbing.

DIY · native Pinterest API

Register a developer app and configure OAuth redirect URLs
Implement the OAuth flow plus token refresh and rotation
Build the media-upload and publish flow around Pinterest's quirks
Clear access requirements — review, quota, or partner approval where required
Build scheduling, retries, and failure alerting yourself
Keep up with API version changes — forever

PostPulse

Minute 0 · Sign up free
Minute 3 · Connect a Pinterest account via OAuth
Minute 6 · POST /v1/posts — first post live
Minute 7 · A webhook calls your URL the second it lands
Day 2+ · Build your product, not platform plumbing

Pinterest-specific API settings

Control Pinterest publishing options via the platformSettings object in your publication entry.

Field	Description	Accepted Values
`title`	Pin title (optional, up to 100 characters)	string
`link`	Destination URL opened when someone clicks the Pin (optional)	string
`altText`	Alt text describing the Pin image (optional)	string
`boardSectionId`	Section within the selected board to pin into (optional)	string

Pinterest media requirements

PostPulse validates your media before publishing to Pinterest to prevent platform rejections.

Image Formats

JPG
PNG
WEBP

Max size: 20 MB

Video Formats

Max size: 2 GB

Max Attachments

5 files per post

Simple, usage-based pricing

Private-label is self-serve. White-label is for partners reselling publishing under their own brand.

Private-label · Pay-as-you-go

$0.20/ publication

No subscription
Unlimited connected accounts
Pay only when you publish

Start free

Most popularPrivate-label · Subscription

$5/ account / mo

Or $48 / year per account
Unlimited posts
REST API · n8n · Make · MCP

Choose subscription

White-Label

$200/ mo + $1 / active acct

Fully branded, native UX
Idle accounts are free
Startup fee waiver available

Talk to us

Compare plans in detail →

PostPulse vs. the native Pinterest API

What PostPulse handles vs. what you'd build yourself.

Capability	PostPulse	Native Pinterest API
Platform audit / App Review	✓ Not required	✗ Required (weeks to months)
Auth token management	✓ Handled by PostPulse	Implement OAuth + token refresh
Media upload workflow	✓ Single endpoint	Multi-step async upload
Post scheduling	✓ Built-in scheduledTime	Build your own cron queue
Failure notifications	✓ 14 webhook events	Poll for status manually
Multi-platform publishing	✓ 10 platforms, same request	Separate API per platform
White-label OAuth for your users	✓ Included	Build your own OAuth bridge
AI agent integration (MCP)	✓ Claude, Cursor	✗ Not available

James Mccarthy

I use PostPulse with an AI agent via their MCP server. My agent literally posts to social media on its own now. Didn’t expect that to work as smoothly as it did.

Antonio Widera

$5/month for what would otherwise require a full backend engineer to maintain? Easy yes. The REST API is clean and well-documented too, which is rare.

Shawn Padilla

Tried to get TikTok API access myself. Three weeks, two rejections. Switched to PostPulse and was posting to TikTok the same day. Wish I hadn’t wasted that time.

Karen Rivers

I’m a Make.com power user and needed to post to 5 platforms from one scenario. The native PostPulse app for Make connected everything in one afternoon. Would’ve taken me weeks to do manually.

Douglas Finch

I built an n8n automation for a client and needed to add social publishing. The official PostPulse n8n node was literally drag and drop. No headache.

Andrea Scott

Saved me months of dev work. I was about to start integrating Instagram and TikTok APIs separately — then I found out Meta’s app review alone can take months. PostPulse just handled all of that. Shipped social posting in under a week.

William Dirks

The most flexible pricing model on the market!

I'm building an AI content factory as a side hustle. I'm still in the experimentation phase, so I don't have the budget for expensive tools — but I also needed to get everything up and running quickly, so I integrated with a ready-to-go API instead. PostPulse offers a flexible pay-as-you-go model that let me experiment first without commitment — and now that we have stable traffic, I’ve switched to their $5/month subscription.

Best support on the market — the founder personally emailed me when I hit a client error and walked me through the fix.

solo serg

We optimized the posting to 20 twitter accounts. It was a problem to manage such a number, but through the platform everything works out perfectly. Very convenient dashboard for tracking errors. Great product.