Create Board

Creates a board to pin to, public, protected, or secret

Creates a board to pin to, public, protected, or secret.

App	Pinterest Organic
Operation ID	pinterest_create_board
Type	Action
Connection	pinterest (required)
Credits per run	1
Agent / MCP tool	Yes
Requires approval	Yes (write operation)

Inputs

Field	Type	Required	Default	Description
name	string	Yes	-	The board name, up to 180 characters. Ask the user for it if it is not provided.
description	string	No	-	What the board is about, up to 500 characters. Keywords here help Pinterest surface the board in search.
privacy	string or SelectableOption	No	PUBLIC	Who can see the board. Available options: ‘PUBLIC’ (anyone can see the board), ‘SECRET’ (only the account owner and the board’s collaborators can see it) or ‘PROTECTED’ (Pinterest’s ad only board type, kept off the public profile). Defaults to ‘PUBLIC’.

SelectableOption

Field	Type	Required	Default	Description
value	string	Yes	-
label	string	Yes	-

Output

Type: Dict

Returns the new board’s id and settings.

Fields: board_id, name, description, privacy, created_at

Example:

{
  "board_id": "549755885175",
  "name": "Autumn recipes",
  "privacy": "PUBLIC"
}