Connect your account
- In the sidebar, open Channels and click Connect channel (or use New > Connect a new channel)
- Choose Pinterest and click Connect Pinterest
- Authorize TryPost on Pinterest
- On the confirmation page, check the account and click Finish connection
Board selection
Pinterest requires every pin to belong to a board. When you post to a Pinterest channel, its settings in the editor show Pinning to with a searchable board list. Pick a board, or type a name and click Create to make a new one. A post without a board cannot be scheduled or published — the editor, the REST API and MCP all reject it with Select a Pinterest board to publish this post. On the API, send the board asmeta.board_id; list boards with List Pinterest boards (GET /social-accounts/{account}/boards) and create one with Create Pinterest board (POST /social-accounts/{account}/boards).
Supported content types
The attached media decides the type.
Media limits
Official specs: Creating boards and pins, Product specs. Full catalog: Media.
Text and per-post options
- Description — the post text, up to 800 characters.
- Title — optional pin title (
meta.title, up to 100 characters). - Destination link — where the pin leads (
meta.link, http or https, up to 2,048 characters). - Video cover — pick the cover frame of a video pin in Edit Media > Thumbnail.
- Alt text — up to 500 characters per image.
Insights
Pinterest pins and followers appear in Insights.OAuth scopes
boards:read, boards:write, pins:read, pins:write, user_accounts:read
pins:read and user_accounts:read are required for Pinterest metrics in Insights. boards:read powers the board picker and boards:write creating boards.
Self-hosting setup
Configure Pinterest API credentials
Configure Pinterest API credentials
- Go to Pinterest Developers and create an app
- Add the scopes listed above in the app’s permissions
- Set the redirect URL to
{APP_URL}/accounts/pinterest/callback - Add to your
.env:
PINTEREST_ENABLED=false.
