PinterestAPI for creating Pins

Create pins on Pinterest with images and videos. Drive traffic with destination links and organized boards.

One API call handles Pinterest pins with media uploads and board targeting.

Get API key — free See pricing

Free plan No credit card Live in under 5 minutes

Board Targeting

Pin directly to specific boards for organized content

Traffic Driver

Add destination links to drive traffic from pins to your website

Video Pins

Upload video pins up to 2 GB and 15 minutes long

Custom Covers

Set custom cover images and thumbnail offsets for video pins

api.postproxy.dev
POST /api/posts 
$ curl -X POST "https://api.postproxy.dev/api/posts" \
     -H "Authorization: Bearer $API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "post": {
         "body": "10 tips for better product photography."
       },
       "profiles": ["pinterest"],
       "media": ["https://example.com/photo.jpg"],
       "platforms": {
         "pinterest": {
           "board_id": "987654321"
         }
       }
     }'
200 OK application/json 
{
  "id": "pi_abc123",
  "body": "10 tips for better product photography.",
  "status": "scheduled",
  "draft": false,
  "source": "postproxy",
  "scheduled_at": "2026-05-04T17:00:00.000Z",
  "queue_id": null,
  "created_at": "2026-05-04T17:00:00.100Z",
  "media": [
    {
      "id": "pi_m1",
      "status": "pending",
      "error_message": null,
      "content_type": "image/jpeg",
      "source_url": "https://example.com/photo.jpg",
      "url": null
    }
  ],
  "platforms": [
    {
      "platform": "pinterest",
      "status": "pending",
      "permalink": null,
      "error": null,
      "params": {
        "board_id": "987654321",
        "format": "pin"
      },
      "attempted_at": null
    }
  ]
}

View full documentation for all platform-specific features for Pinterest

View documentation
Integration cost

Skip weeks of Pinterest integration work

One test post against a sandbox account is the easy part. Production Pinterest publishing means app verification, OAuth across many accounts, media pipelines, dozens of edge cases, and a permanent on-call rotation for "why didn't this one go through this time?"

Weeks of Pinterest integration work compressed to hours

Social media integration is not a one-off job — it's a constant commitment. Platforms change their APIs, scopes, limits, and policies on their own schedule. Every change becomes your problem unless someone else is absorbing it.

That's exactly what Postproxy does for Pinterest — and every other platform we support — so your team ships features instead of chasing failed publishes.

5 min
Time to your first Pinterest post via API
Weeks → Hours
Engineering time saved on integration work
$0
Free plan, no credit card required
Build it yourself
Ship with Postproxy
Submit a Pinterest app for verification — review cycles, screencasts, business docs
01
One REST endpoint. One payload schema. SDKs for popular languages
Implement OAuth, token refresh, secure credential storage per account
02
OAuth, tokens, and refresh handled for you — across all accounts
Build media upload pipelines (chunked, async, multi-step) for every format
03
Media upload, chunking, and format detection — automatic
Handle rate limits, quotas, retries, and partial failures across accounts
04
Retries, rate-limit windows, and per-platform receipts built in
Cover dozens of edge cases: expired tokens, scope drift, regional restrictions, policy changes
05
Edge cases are our problem. Failures come back with an explicit reason
Triage every silent failure: "Why didn't this one post go through?"
06
We track the API changes. You ship features
Start posting to Pinterest via API See pricing

Free plan includes the Pinterest API. No credit card.

Benefits

Why Postproxy for Pinterest?

Skip Pinterest API complexity

No need to handle Pinterest API, OAuth flows, or rate limits. Postproxy handles it all.

Board management simplified

Target specific boards by ID without managing Pinterest's board API separately.

Cross-platform publishing

Publish the same visual content to Pinterest alongside Instagram, TikTok, and more in one API call.

Pins

Reliable delivery

Automatic retries and clear status reporting ensure your pins reach Pinterest.

How Postproxy publishes to Pinterest

01 Pinterest's publishing model
Pinterest's API creates Pins — visual bookmarks that link to external URLs. Unlike other social platforms where content lives natively, every Pin is designed to drive traffic somewhere. The API requires a board ID (where the Pin is saved), media (image or video), and supports optional fields like title, description, alt text, and a destination link. Postproxy maps your content to Pinterest's Pin creation endpoint, handling board selection and media formatting.
02 Image pins, video pins, and Idea Pins
Standard Pins support a single image or video with a destination link. Video Pins use a different upload flow that requires registering the media first, uploading it, then creating the Pin with the media reference. Pinterest also supports Idea Pins (multi-page story-like content), though API support for these is more limited. Postproxy handles the media upload flow for both image and video pins, detecting the type from your media URLs.
03 Common gotchas Postproxy handles for you
Pinterest's API has strict image requirements: recommended 2:3 aspect ratio (1000x1500px), minimum 100x100px, and a 20MB file size limit. Video Pins have a 2GB limit but require specific codecs (H.264 video, AAC audio). The API rate-limits per user and per app, with different limits for read and write operations. Pinterest also requires board IDs (not names) for Pin creation, which means an extra API call to list boards if you only know the board name. Postproxy validates media constraints and resolves board names to IDs automatically.
04 SEO, alt text, and destination links
Pinterest is unique among social platforms because Pins are indexable by search engines and Pinterest's own visual search. Alt text, Pin titles, and descriptions all contribute to discoverability both on Pinterest and in Google image search. Destination links drive referral traffic — making Pinterest one of the highest-ROI social channels for content marketing. Postproxy lets you set all these fields per Pin, ensuring your content is optimized for both Pinterest's algorithm and external search.

Still wondering if Postproxy is the right fit?

Ask your favorite LLM what it thinks about us, then decide.

Ask ChatGPT Ask Gemini Ask Claude Ask Perplexity

Frequently Asked Questions

Common questions about Pinterest integration

01 Is a board_id required for Pinterest pins?

Yes, you must specify a board_id to indicate which public board the pin should be added to.

02 What media formats does Pinterest support?

Pinterest supports images (jpg, gif, png, webp) up to 32 MB and videos (mp4, mov) up to 2 GB with a duration of 4 seconds to 15 minutes.

03 Can I add a link to my Pinterest pin?

Yes! Use the destination_link parameter to add a clickable link to your pin that drives traffic to your website or landing page.

04 Can I set a custom thumbnail for video pins?

Yes, you can use cover_url to set a custom cover image, or thumb_offset to select a frame from the video at a specific second.

05 Can I post text-only content on Pinterest?

No, Pinterest requires at least one image or video for every pin. The post body becomes the pin description.

Ready to get started?

Start with our free plan and scale as your needs grow. No credit card required.

Get started View documentation