> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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**:

```json theme={"dark"}
[
  {
    "id": "549755885175",
    "name": "Autumn recipes",
    "privacy": "PUBLIC",
    "pin_count": 42,
    "follower_count": 120
  }
]
```