---
title: "PM · Boards · Create a new PM board with optional initial status columns"
method: POST
path: "/api/v1/pm/boards"
tags: ["boards"]
---

# PM · Boards · Create a new PM board with optional initial status columns

`POST /api/v1/pm/boards`

## Request

- Base URL: `https://api.simplified.com`
- URL: `https://api.simplified.com/api/v1/pm/boards`
- Auth: API key in header `Authorization`

Create a new PM board in the workspace. Optionally seed it with an initial
set of statuses (columns) in one call via the `statuses` field.
`primary_type` is `pm` (default) or `blogger` — lowercase, no other values.
`access` controls visibility: 0=PRIVATE, 1=PROTECTED, 2=PUBLIC.

## Headers

- `Organization` string
- `Space` string

## Request body

- BoardCreateRequest: Create a new board. Workspace and space are inferred from the `Organization` and `Space` headers.
  - `title` string: Board title. Defaults to "{workspace} Project" if omitted.
  - `description` string: Board description.
  - `access` integer: Board access: 0=PRIVATE (default), 1=PROTECTED (workspace-shared), 2=PUBLIC.
  - `primary_type` 'pm' | 'blogger': Board type discriminator. Lowercase; `pm` for task boards, `blogger` for blog boards.
  - `statuses` BoardCreateRequestStatusesItems[]: Optional inline status definitions to seed the board with. If omitted, the board gets the 4 default statuses (Draft / To Do / In Progress / Completed).
    - `title` string, required
    - `color` string: Hex color string, e.g. "#008CD3".
  - `extra` object: Free-form board configuration (`_config` on the model).

## Response `201`

Board created.

- unknown

---

[API](https://skmtc.dev/simplified/apis/project-manager.md) - [All operations](https://skmtc.dev/simplified/apis/project-manager/llms.txt) - [OpenAPI document](https://skmtc.dev/simplified/apis/project-manager/revisions/9ef06e133a13?raw)