The Pinterest scheduling API

Create a Pinterest post with one HTTP call. It joins the same queue the dashboard uses, retries on failure, and reports back what actually went out.

Publish to Pinterest

# POST a text-and-media post to your connected Pinterest channel
curl -X POST https://api.postwharf.com/v1/posts \
  -H "Authorization: Bearer $POSTWHARF_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Shipping today.",
    "channels": ["ch_your_pinterest_channel"],
    "media": ["med_optional"]
  }'

Schedule it instead

curl -X POST https://api.postwharf.com/v1/posts \
  -H "Authorization: Bearer $POSTWHARF_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Tuesday drop","channels":["ch_your_pinterest_channel"],"publish_at":"2026-09-01T09:00:00Z"}'

Find your Pinterest channel id

curl https://api.postwharf.com/v1/channels \
  -H "Authorization: Bearer $POSTWHARF_KEY"

Each connected account is a channel. The one you want has "platform": "pinterest".

Check what happened

curl https://api.postwharf.com/v1/posts/post_xxx \
  -H "Authorization: Bearer $POSTWHARF_KEY"

The response carries one delivery per channel with its status, the live URL once published, and the error text if it failed. Deliveries are re-checked after publishing, so a Pinterest post removed later stops reporting as live.

What Pinterest accepts

500 characters, counting the pin description. Up to 1 image or 1 video per post — Pinterest does not take both in the same post.

Read from the table the API enforces, so a post over 500 is refused when you create it rather than truncated on the way to Pinterest.

Worth knowing about Pinterest

Every pin needs a destination link and a board.

Every other network

Instagram · TikTok · X · LinkedIn · YouTube · Facebook · Threads · Bluesky · Reddit · Telegram · Discord · Snapchat · WordPress