Skip to main content

​
Pinterest

TryPost supports creating pins on Pinterest.

​
Connect your account

  1. Go to Accounts in the TryPost dashboard
  2. Click Connect Pinterest
  3. Authorize TryPost on Pinterest

​
Board selection

Pinterest requires every pin to belong to a board. TryPost loads your boards over the API and lets you pick one in two places:
  • Per post — when you target a Pinterest account in the post editor, the platform sidebar shows a Board dropdown. Pick the board for that specific pin.
  • Default board (optional) — set a workspace default in Accounts → your Pinterest account → Default board. New Pinterest posts pre-fill the picker with this board; you can still override per post.
If neither a per-post board_id nor a default board is set, publishing fails with Pinterest board_id is required. The post editor blocks scheduling until you pick a board; the REST API and MCP only fail at publish time, so callers must provide platforms[].meta.board_id themselves.

​
Supported content types

TypeAspect ratioDescription
Pin2:3Image pin (1 image, required)
Video Pin9:16Video pin, 4 seconds to 15 minutes (1 video, required)
Carousel2:3Multi-image pin (up to 5 images, required)

​
OAuth scopes

boards:read, boards:write, pins:read, pins:write, user_accounts:read pins:read and user_accounts:read are required for the Analytics dashboard. boards:read powers the board picker.

​
Self-hosting setup

  1. Go to Pinterest Developers and create an app
  2. Add the scopes listed above in the app’s permissions
  3. Set the redirect URL to {APP_URL}/accounts/pinterest/callback
  4. Add to your .env:
PINTEREST_CLIENT_ID=your_app_id
PINTEREST_CLIENT_SECRET=your_app_secret
PINTEREST_CLIENT_REDIRECT="${APP_URL}/accounts/pinterest/callback"