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.

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

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

 Text 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 Text 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 Text 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 Text FALSE

Output

Field Definition Type

Board

ID

Unique identification number for the board.

 Text

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.

 Text

Workspace

The workspace where the board is located:

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

  • Name - The name of the workspace - Text

 Object

Owners

The owners of the board:

  • ID - The unique identifier for the owner - Text

  • 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 - Text

  • 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 - Text

  • 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