Skip to content
DunSocial Docs

Pinterest

Publish image Pins through MCP with boards and one image.

Prefer schedule_pinterest_post and publish_pinterest_now. Do not treat create_draft as a successful Pin.

Flow

  1. list_social_accounts — find the Pinterest account id
  2. list_pinterest_boards — pick a real boardId (do not guess)
  3. get_upload_url → PUT the image → complete_upload
  4. publish_pinterest_now (or schedule) with:
    • socialAccountId
    • boardId
    • title (up to 100 characters)
    • description (up to 800)
    • exactly one entry in mediaUrls
    • optional link, boardName

Example ask

Upload this image, then publish a Pin to my Landing page board titled “Core Flows” with a short description and link to dunsocial.com.

Drafts

If you only want a draft for the web composer, use create_draft with selectedPlatforms: ["pinterest"] plus board/title options. That still does not publish.

Common mistakes

  • Using a board name instead of boardId from list_pinterest_boards
  • Passing more than one image
  • Skipping complete_upload after the PUT
  • Assuming a draft is live on Pinterest