Pinterest API guide

Publish Pins with a title, description, destination link and board. Platform key: pinterest.

Last checked against the API October 10, 2026 · View as Markdown

Platform key	`pinterest`
Text limit	500 characters (description); 100 (title)
Media	Required: one image.

Things to know

content becomes the Pin description. Without settings.title, the first 100 characters of the text are used.
Without boardId, the Pin goes to your default board, or your first board if none is set.

Settings

Optional Pinterest options go in platform_content.pinterest.settings. Invalid values are rejected when you create or update the post, with a message naming the field.

Field	Type	Description
`boardId`	string	The Pinterest board to pin to.
`title`	string, up to 100 characters	The Pin title.
`link`	http(s) URL	Where the Pin sends people.

platform_content.pinterest

"pinterest": {
  "content": "Five cosy autumn drinks you can make at home.",
  "settings": { "title": "Autumn coffee recipes", "link": "https://example.com/autumn-recipes" }
}

Example

POST /api/v1/posts

{
  "base_content": "Our autumn menu is here.",
  "platforms": ["pinterest"],
  "platform_content": {
    "pinterest": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}

Other platforms: LinkedIn, X (Twitter), TikTok, YouTube, Bluesky. Writing limits for every network are in our character limit reference, and the Pinterest scheduler page covers scheduling from the app.

PreviousYouTube NextBluesky