List Boards

Lists the account’s boards as Pinterest returns them, with id, name, privacy, pin count, and follower count

Lists the account’s boards as Pinterest returns them, with id, name, privacy, pin count, and follower count. Use this to find the board id that publishing a pin needs.

App	Pinterest Organic
Operation ID	pinterest_list_boards
Type	Action
Connection	pinterest (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
privacy	string or SelectableOption	No	-	Optional filter to return only boards with this privacy. 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). Leave empty to return boards of every privacy.
limit	integer	No	100	Maximum number of boards to return, between 1 and 500. Default is 100.

SelectableOption

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

Output

Type: List[Dict]

Returns the boards exactly as Pinterest returns them.

Fields: dynamic (depend on the inputs)

Example:

[
  {
    "id": "549755885175",
    "name": "Autumn recipes",
    "privacy": "PUBLIC",
    "pin_count": 42,
    "follower_count": 120
  }
]