Pinterest API and MCP

Select the Pinterest account and boardId, then build a media publish request.

Call blotato_list_pinterest_boards with the Pinterest accountId. Use the selected board's id as boardId. REST lookup: GET /v2/social/pinterest/boards?accountId=....

Fields

Field	Use
boardId	Required board ID from the board lookup.
title	Optional title, up to 100 characters.
altText	Optional image description, up to 500 characters.
link	Optional destination URL, up to 2,048 characters.

For MCP, pass platform-specific fields alongside accountId, platform, text, and mediaUrls. For REST, platform-specific target fields belong inside post.target. Thread content belongs inside post.content.additionalPosts.

Media and formats

Use an image, a video, or 2–5 images for a carousel. A video Pin contains one video. The publisher rejects more than 5 media items.

Read Pinterest media requirements and upload and conversion rules. Public media URLs go directly in mediaUrls. No upload step required.

MCP example

Call blotato_create_post with the following shape. Replace lookup IDs and example media URLs with returned IDs and your media. Adjust the example's settings to the user's request.

{
  "accountId": "ACCOUNT_ID_FROM_LOOKUP",
  "platform": "pinterest",
  "text": "A description for your Pin.",
  "mediaUrls": [
    "https://example.com/image.jpg"
  ],
  "boardId": "BOARD_ID_FROM_LOOKUP"
}

REST example

Send this JSON to POST https://backend.blotato.com/v2/posts with your blotato-api-key header.

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "pinterest",
      "text": "A description for your Pin.",
      "mediaUrls": [
        "https://example.com/image.jpg"
      ]
    },
    "target": {
      "targetType": "pinterest",
      "boardId": "BOARD_ID_FROM_LOOKUP"
    }
  }
}

Verify the result

1. Save the returned postSubmissionId.

2. If processing continues, use blotato_get_post_status or GET /v2/posts/:postSubmissionId.

3. Report the returned status and public URL when supplied.

For scheduling, add scheduledTime or useNextFreeSlot as an MCP argument or a REST top-level sibling of post. See Scheduling and completion rules.

Limits and troubleshooting

Pinterest account eligibility and connection requirements apply before publishing. Read the connection troubleshooting page if the account is blocked from API publishing.

See Pinterest account guide, platform help, and the Publish Post reference for options and examples.