PostWing
Pinterest API

Pinterest posting API for developers and agents

Schedule Pinterest pins from one REST API. Built for scripts, custom apps, and AI agents.

  • 7-day free trial
  • Pins + boards
  • Plans from $9.99/mo

step by step

How to post to Pinterest with the API

Create a key, connect Pinterest, pick a board, then schedule a pin.

01Create an API key

Open Dashboard → AI & API, create a key, and send it as Authorization: Bearer pw_live_…. Connect your Pinterest account if you have not already.

Endpoints

API base URL

https://postwing.io/api/v1

Docs

https://postwing.io/docs
02Schedule to Pinterest

List boards first, then call POST /posts/preview with board_ids on the Pinterest target. Full field reference is in the API docs.

Example Pinterest pin
curl -s -X POST "https://postwing.io/api/v1/posts/preview" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "New lookbook",
  "scheduled_at": "2026-10-05T18:00:00Z",
  "targets": [
    {
      "account_id": "pinterest-account-uuid",
      "platform_options": {
        "board_ids": [
          "1234567890"
        ],
        "title": "Lookbook",
        "link": "https://example.com/shop"
      }
    }
  ],
  "media_items": [
    {
      "url": "https://cdn.example.com/pin.jpg",
      "type": "image"
    }
  ]
}'

what you can do

Pinterest posting from one API

Same PostWing API as the full product, scoped to Pinterest when you target a Pinterest account.

  • Schedule Pinterest pins to one or more boards
  • List boards with GET /accounts/pinterest-boards
  • Set pin title and destination link
  • Upload images or video with a direct upload URL
  • Edit or cancel scheduled Pinterest pins from the same API
See Pinterest platform options

built for Pinterest

Pins with boards in one flow

Fetch boards, pick board_ids, set an optional title and link, then schedule. board_ids are required for every Pinterest pin.

  • Image pins for product and lifestyle content
  • Video pins when your media is a video file
  • Scheduled pins show up on your PostWing calendar

Pinterest options

Platform settings that matter

Pass these on targets[].platform_options. board_ids are required.

  • board_ids required board IDs from GET /accounts/pinterest-boards
  • title optional pin title
  • link optional destination URL
  • Preview → confirm so nothing schedules without approval
  • API key or OAuth with scoped access

one API

Same API for every network

There is no separate Pinterest product. Pass platforms or targets[] on the same preview → confirm flow. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.

  • Facebook
  • Threads
  • Pinterest
  • YouTube
  • LinkedIn
  • X (Twitter)
  • Instagram
  • TikTok

Connect accounts once in PostWing (or via the accounts endpoints)

Call POST /posts/preview with the networks you want on that post

Confirm with the token. One key covers every platform PostWing supports.

questions

Pinterest posting API FAQ

Yes. Call GET /accounts/pinterest-boards, then pass board_ids on targets[].platform_options when you preview the pin.

ready when you are

Schedule your next Pinterest pin from the API

Create an API key, connect Pinterest, and schedule pins from your app.

7-day free trial · Cancel anytime