ShortSync

A REST API for Creating Pins

One Bearer token, one POST endpoint, no Pinterest app review. Create image and video Pins on any of your boards from any HTTP client.

One call to Pinterest

Pinterest's own API starts you on trial access until your app is reviewed, and video Pins need their own upload flow. ShortSync handles that, so a Pin is the same JSON you send for any other platform.

POST https://api.shortsync.app/v1/posts
Authorization: Bearer ss_live_<your-token>
Content-Type: application/json

{
  "upload_id": "up_01HW0ZAB3CDEFGHJKMNPQRSTUV",
  "publish_mode": "scheduled",
  "scheduled_for": "2026-11-05T18:00:00Z",
  "caption": "A 5-minute miso soup for busy weeknights. Full recipe on the blog.",
  "targets": [
    {
      "connection_id": "con_pinterest_...",
      "platform_options": {
        "pinterest": {
          "board_id": "<board id from /platforms/pinterest/boards>",
          "title": "5-minute miso soup",
          "link": "https://example.com/miso-soup",
          "alt_text": "Bowl of miso soup with tofu and spring onions"
        }
      }
    }
  ]
}

Add more targets to post the same image or video to Instagram, TikTok, YouTube, Facebook, LinkedIn and the rest of the 17 platforms in the same call.

Boards, links and alt text

Pick a board per Pin with board_id, or rely on your default board. Each Pin gets its own title, outbound link and alt text, and the caption becomes the description. Already have the file online? Send its link as source_url to POST /v1/uploads and skip the upload step.

Pinterest API FAQ

Yes. ShortSync's public REST API creates Pins from the same endpoint it uses for every other platform. Connect your Pinterest account once in the dashboard, then post with Bearer-token HTTPS calls.
No. Pinterest gives new apps limited trial access until they pass its review. ShortSync's app already has that access; you only need a ShortSync API key and your connected Pinterest account.
List your boards with GET /v1/platforms/pinterest/boards and pass the id as platform_options.pinterest.board_id. If you set a default board in ShortSync, you can leave it out.
Image and video Pins with a title (up to 100 characters), a description from the caption, an outbound link and alt text (up to 500 characters). Schedule them with publish_mode "scheduled".
ShortSync's API is available on every plan, including Free. The Free plan has a smaller monthly request cap and the 5-uploads-per-month limit; Creator and Team plans get higher caps and unlimited posts.

Related guides