> ## 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.

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

```json theme={"dark"}
{
  "board_id": "549755885175",
  "name": "Autumn recipes",
  "privacy": "PUBLIC"
}
```