How do I choose a board?

Call GET /accounts/{id}/pinterest-boards?account id= with the Pinterest account id from sync. Copy id from the board you want and send it in accounts[].options.board_id.

Can one pin go to more than one board?

Each pin goes to one board, set with board_id. To pin the same image to another board, create a second post with that board_id.

Are title and link required?

No. board_id is required. title and link are optional fields on the same options object. title is the pin title. link is the destination URL.

Can I post a video pin?

Yes. Send one media item with type video, plus board_id. Videos imported from a URL need to be 100MB or smaller.

Do I call the Pinterest API myself?

You call PostWing. PostWing publishes the pin for you. You list boards, then create the pin.

What if I have more than one Pinterest account?

Sync, or GET /accounts, returns every Pinterest account. Copy the account id for the one you want. List boards with that same id.

Where does the pin show up after I create it?

On your PostWing calendar right away, in the same workspace as posts you create in the dashboard. Pinterest publishes it at scheduled_at. The response includes dashboard_url.

Can one request post the pin and other channels?

Yes. Keep board_id on the Pinterest account, and add the other account ids to accounts. They publish together at scheduled_at. The pin still needs an image or a video.

Is the API included in the plan?

Yes. API access works with an active PostWing subscription, including the 7-day free trial. Plans start at $9.99/mo. There is no separate API quota beyond rate limits.

Pinterest API

How to post on Pinterest
using the API

Post and schedule pins on Pinterest programmatically using the API. Create a key, connect Pinterest, and create the pin.

the whole flow

Four steps, then it is scheduled

You call PostWing. PostWing publishes to Pinterest at the time you set. The post also shows up on your calendar.

01Create an API key
02Connect Pinterest
03Create the pin
04Cross-post to more channels

Create an API key

Open Dashboard → AI & API and create a key. Copy it once. It starts with pw_live_. Send it on every request:

Header

Authorization: Bearer pw_live_…

Every URL below starts at https://postwing.io/api/v2.

Connect Pinterest

Connect the Pinterest account you want to pin from. You only do this once.

The simple way is in the dashboard. Open Accounts, choose Pinterest, and finish the Pinterest login.

From the API, start that same login. The response includes a url. Open it and approve Pinterest.

Start connect

curl -s -X POST "https://postwing.io/api/v2/accounts/connect" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "pinterest" }'

After you finish in the browser, sync. This imports the account into your workspace and returns the account id.

Sync

curl -s -X POST "https://postwing.io/api/v2/accounts/sync" \
  -H "Authorization: Bearer pw_live_…"

In the response, find the object where platform is pinterest and copy id. That is the id you send when you create the pin and when you list boards.

Sync response

{
  "data": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "platform": "pinterest",
      "handle": "brand",
      "display_name": "Brand",
      "status": "connected"
    }
  ]
}

Connected Pinterest in the dashboard instead? List accounts and copy the same field:

List accounts

curl -s -X GET "https://postwing.io/api/v2/accounts" \
  -H "Authorization: Bearer pw_live_…"

Create the pin

A pin needs a board and an image or a video. A caption by itself is not enough. caption is the pin description. List boards first, then copy the board id.

List boards

curl -s -X GET "https://postwing.io/api/v2/accounts/f6a7b8c9-d0e1-2345-f012-456789012345/pinterest-boards" \
  -H "Authorization: Bearer pw_live_…"

Boards response

{
  "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
  "boards": [
    { "id": "1234567890", "name": "Lookbook" }
  ]
}

Copy id from the board you want. Send it as board_id on the Pinterest account, with the image, a future time, and the account id from sync. This call schedules the pin. Pinterest publishes it at scheduled_at. scheduled_at is UTC.

Create an image pin

curl -s -X POST "https://postwing.io/api/v2/posts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "New lookbook, now live.",
  "scheduled_at": "2026-10-12T15:00:00Z",
  "accounts": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "options": {
        "board_id": "1234567890"
      }
    }
  ],
  "media": [
    { "url": "https://cdn.example.com/lookbook.jpg", "type": "image" }
  ]
}'

You get back three things that matter:

id: the post id, for edits or cancelling later
status: scheduled until it publishes
accounts: each account, with url once it is live and error if it fails

Response

{
  "id": "7c1d2a8e-4b0f-4f8e-9a51-2f7f6b1c9d10",
  "status": "scheduled",
  "caption": "New lookbook, now live.",
  "scheduled_at": "2026-10-12T15:00:00.000Z",
  "accounts": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "platform": "pinterest",
      "handle": "brand",
      "status": "scheduled",
      "url": null,
      "error": null
    }
  ],
  "dashboard_url": "https://postwing.io/dashboard/post/7c1d2a8e-4b0f-4f8e-9a51-2f7f6b1c9d10"
}

One image per pin. The image URL has to be public HTTPS.

Cross-post to all 8 platforms

The same image can go to Instagram and Facebook. Connect each channel the way you connected Pinterest, then copy its id from the sync response.

Connect Instagram

curl -s -X POST "https://postwing.io/api/v2/accounts/connect" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "instagram" }'

Connect Facebook

curl -s -X POST "https://postwing.io/api/v2/accounts/connect" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{ "platform": "facebook" }'

Open each url, finish the login, then sync once. Copy id where platform is instagram, and where platform is facebook.

Add those ids to accounts on the create call. Keep board_id on the Pinterest account only. One request. Every account publishes at the same scheduled_at. Leave caption off an account to use the shared caption. Set caption when that channel needs different text.

Create one image post for three channels

curl -s -X POST "https://postwing.io/api/v2/posts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "New lookbook, now live.",
  "scheduled_at": "2026-10-12T15:00:00Z",
  "accounts": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "options": {
        "board_id": "1234567890"
      }
    },
    { "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901" },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "caption": "The new lookbook is up."
    }
  ],
  "media": [
    { "url": "https://cdn.example.com/lookbook.jpg", "type": "image" }
  ]
}'

That image can also go to LinkedIn, X, Threads, and TikTok. YouTube needs a video. Pinterest still needs board_id in its own options.

pin details

Add a title and a link

Title and link are optional. Keep board_id. title is the pin title. link is the page the pin opens.

Create a pin with a title and a link

curl -s -X POST "https://postwing.io/api/v2/posts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "New lookbook, now live.",
  "scheduled_at": "2026-10-12T15:00:00Z",
  "accounts": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "options": {
        "board_id": "1234567890",
        "title": "Lookbook",
        "link": "https://example.com/shop"
      }
    }
  ],
  "media": [
    { "url": "https://cdn.example.com/lookbook.jpg", "type": "image" }
  ]
}'

Leave title and link off when you do not need them. A title is capped at 100 characters. The description in caption is capped at about 800 characters.

video

Post a video pin

A video pin is the same request with one video file. You still send board_id.

Create a video pin

curl -s -X POST "https://postwing.io/api/v2/posts" \
  -H "Authorization: Bearer pw_live_…" \
  -H "Content-Type: application/json" \
  -d '{
  "caption": "A look through the new collection",
  "scheduled_at": "2026-10-12T18:00:00Z",
  "accounts": [
    {
      "id": "f6a7b8c9-d0e1-2345-f012-456789012345",
      "options": {
        "board_id": "1234567890"
      }
    }
  ],
  "media": [
    { "url": "https://cdn.example.com/lookbook.mp4", "type": "video" }
  ]
}'

One video per pin. The video URL has to be public HTTPS, and videos imported from a URL need to be 100MB or smaller. A file on your computer uses the direct upload URL, covered in the API docs.

Details worth knowing

scheduled_at has to be a future time in ISO 8601, usually UTC.
POST /posts schedules the pin right away. You can still edit or cancel it until it publishes.
A pin needs an image or a video, plus board_id. A caption by itself is not enough.
One image per pin. A video is one file. Pass more than one board id to pin to several boards.
title and link are optional. board_id are required on the Pinterest account.
The response includes the pin id. Use it to edit with PATCH /posts/{id} or cancel with DELETE /posts/{id}.
API access is included on every plan, from $9.99/mo. Pins count as normal posts on your account.

API docs Pinterest options Pinterest posting API Pricing

questions

Pinterest API FAQ

No. A pin needs an image or a video, and board_id from GET /accounts/{id}/pinterest-boards.

ready when you are

Schedule your next Pinterest pin from the API

Create a key, connect Pinterest, and create the pin.

How to post on Pinterestusing the API