List the Pins on a board
pinterest_ads_list_board_pinsLists Pins on a Pinterest board, including protected Ad-only Pins boards, so you can select a Pin for an ad.
Instructions
List the Pins on a board, e.g. the protected 'Ad-only Pins' board, to pick one for an ad. Apps registered on or after 14 September 2026 may get HTTP 403 PINNER_DATA_ACCESS_DENIED here until Pinterest approves Pinner data access; don't retry.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"board_id": "<board_id>"
},
"name": "pinterest_ads_list_board_pins"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| board_id | Yes | ||
| max_results | No | ||
| ad_account_id | No | ||
| creative_types | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||