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.