---
title: "POST /api/v1/boards"
method: POST
path: "/api/v1/boards"
---

# POST /api/v1/boards

`POST /api/v1/boards`

Creates a new board

## Request body

- Board — Board groups a set of blocks and its layout
  - `cardProperties` object[] — The properties of the board cards
  - `channelId` string — The ID of the channel that the board was created from
  - `columnCalculations` object — The calculations on the board's cards
  - `createAt` integer, required — The creation time
  - `createdBy` string, required — The ID of the user that created the board
  - `deleteAt` integer — The deleted time. Set to indicate this block is deleted
  - `description` string — The description of the board
  - `icon` string — The icon of the board
  - `id` string, required — The ID for the board
  - `isTemplate` boolean — Marks the template boards
  - `modifiedBy` string, required — The ID of the last user that updated the board
  - `properties` object — The properties of the board
  - `showDescription` boolean — Indicates if the board shows the description on the interface
  - `teamId` string, required — The ID of the team that the board belongs to
  - `templateVersion` integer — Marks the template boards
  - `title` string — The title of the board
  - `type` string, required
  - `updateAt` integer, required — The last modified time

## Response `200`

success

- Board — Board groups a set of blocks and its layout
  - `cardProperties` object[] — The properties of the board cards
  - `channelId` string — The ID of the channel that the board was created from
  - `columnCalculations` object — The calculations on the board's cards
  - `createAt` integer, required — The creation time
  - `createdBy` string, required — The ID of the user that created the board
  - `deleteAt` integer — The deleted time. Set to indicate this block is deleted
  - `description` string — The description of the board
  - `icon` string — The icon of the board
  - `id` string, required — The ID for the board
  - `isTemplate` boolean — Marks the template boards
  - `modifiedBy` string, required — The ID of the last user that updated the board
  - `properties` object — The properties of the board
  - `showDescription` boolean — Indicates if the board shows the description on the interface
  - `teamId` string, required — The ID of the team that the board belongs to
  - `templateVersion` integer — Marks the template boards
  - `title` string — The title of the board
  - `type` string, required
  - `updateAt` integer, required — The last modified time

## Other responses

- `default` — internal error

## Changes

- **2022-03-22** `cdfed1e96572` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/mattermost/apis/focalboard-server/changes/api/v1/boards/post.md)

---

[API](https://skmtc.dev/mattermost/apis/focalboard-server.md) · [All operations](https://skmtc.dev/mattermost/apis/focalboard-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mattermost/focalboard-server/revisions/e8bd8dee7882/schema)