step by step
How to post to Pinterest with the API
Create a key, connect Pinterest, pick a board, then schedule a pin.
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/v2Docs
https://postwing.io/docsList boards first, then call POST /posts with options.board_id on your Pinterest account. Full field reference is in the API docs.
curl -s -X POST "https://postwing.io/api/v2/posts" \
-H "Authorization: Bearer pw_live_…" \
-H "Content-Type: application/json" \
-d '{
"caption": "New lookbook",
"scheduled_at": "2026-10-05T18:00:00Z",
"accounts": [
{
"id": "PINTEREST_ACCOUNT_ID",
"options": {
"board_id": "1234567890",
"title": "Lookbook",
"link": "https://example.com/shop"
}
}
],
"media": [
{
"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 post to 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
built for Pinterest
Pins with boards in one flow
Fetch boards, pick a board_id, set an optional title and link, then schedule. board_id is 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
Set these on accounts[].options. board_id is required.
board_idrequired board ID from GET /accounts/{id}/pinterest-boardstitleoptional pin titlelinkoptional destination URL- Clear errors with a code and the exact field to fix
- API key or OAuth with scoped access
one API
Same API for every network
There is no separate Pinterest product. List more account ids in accounts on the same call. Add Instagram, TikTok, YouTube, LinkedIn, X, Facebook, Pinterest, or Threads without changing your integration.
- Threads
- YouTube
- X (Twitter)
- TikTok
Connect accounts once in PostWing (or via the accounts endpoints)
Call POST /posts with every account you want on that post
It is on your calendar. One key covers every platform PostWing supports.
questions
Pinterest posting API FAQ
Yes. Call GET /accounts/{id}/pinterest-boards, then pass options.board_id when you schedule the pin.