List Boards - Markifact

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
`ad_account_id`	integer or string	No	-	Optional, for brand profiles reached through Pinterest Business Access. The id of an ad account owned by that brand profile, e.g. ‘549769672300’. When set, the operation acts on the profile that owns this ad account instead of the signed-in profile. Ad account ids and their owning profile (ownerUsername) come from pinterest_ads_select_accounts. A profile that owns no ad account cannot be reached this way. Leave empty for the signed-in profile.
`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
  }
]