Create Board

Create a board inside a workspace in monday.com.

Input

Field Definition Type Required
Workspace
ID

The workspace identifier.

  • If you don't select this field, or if you leave it blank, the card creates the board inside the provided Folder ID.

  • If you don't provide the Folder ID, the card creates the board inside the default workspace.

  • If you don't provide the Folder ID and the Workspace ID, the card creates the board inside the default workspace.

  • If the provided Workspace ID and Folder ID don't match, the card returns an internal server error.

Number FALSE

Board

Name The name of the created board. Text TRUE
Kind

The kind of board:

  • Public

  • Private

  • Share

Dropdown TRUE
Description The description for the board. Text FALSE
Folder ID The board's folder identifier. Number FALSE
Template ID

The template identifiers. You must have the template saved in your monday.com account. For a template, the Template ID is the same as the Board ID.

Number FALSE
Owner IDs

A list of the user IDs to add as board owners.

  • The board creation happens regardless of whether the users exist or if they are eligible to be owners.

  • When the board is created, any ineligible users are automatically added as subscribers.

Attempting to create a board with a non-existent owner returns the error message: Failed to run users loader.

List of Numbers FALSE
Subscriber IDs

A list of the user IDs to subscribe to the board.

  • The board creation happens regardless of whether the users exist.

List of Numbers FALSE
Subscriber Teams IDs

A list of the team IDs to subscribe to the board.

  • If the team ID doesn’t exist, the card returns an unprocessable content error.

List of Numbers FALSE

Output

Field Definition Type
Board
ID Unique identification number for the board. Number
Name The name of the board. Text
Description The description for the board. Text
Kind

The type of board:

  • Public

  • Private

  • Share

Text
Permissions

The permission set for the board:

  • Everyone

  • Collaborators

  • Assignee

  • Owners

Text
State

The current state of the board:

  • All

  • Active

  • Archived

  • Deleted

Text
Type

The object type of the board:

  • Board

  • Sub items board

  • Document

Text
Updated At The last time the board was updated. Date & Time
Folder ID The unique identifier of the folder that contains the board. Number
Workspace

The workspace where the board is located:

  • ID - The unique identifier for the workspace. This is null for the main workspace - Number

  • Name - The name of the workspace - Text

Object
Owners

The owners of the board:

  • ID - The unique identifier for the owner - Number

  • Name - The name of the owner - Text

  • Email - The email address of the owner - Text

List of Objects
Creator

The creator of the board:

  • ID - The unique identifier for the creator - Number

  • Name - The name of the creator - Text

  • Email - The email address of the creator - Text

Object
Subscribers

A list of the subscribers to the board:

  • ID - The unique identifier for the user - Number

  • Name - The name of the user - Text

  • Email - The email address of the user - Text

List of Objects
Groups

A list of the visible groups belonging to the board:

  • ID - The group's identifier, unique only to its board - Text

  • Title - The title of the group - Text

List of Objects
Columns

A list of the visible columns belonging to the board:

  • ID - The column's identifier, unique only to its board - Text

  • Title - The title of the column - Text

List of Objects

Related topics

monday.com connector

Workflow elements

monday.com API