Use this tool to add items to a monday.com board. You can create a brand-new item with initial column values, create a sub-item beneath an existing parent item, or duplicate an existing item and override specific column values. The item is added to the top group of the board unless you specify a groupId.

🚧
Precondition: Call get_board_info before creating items on an unfamiliar board to retrieve the correct column IDs, column types, group IDs, and status label names. Using incorrect column IDs or value formats will result in errors.

The columnValues parameter is a JSON string. Column value formats differ by type — for status columns use {"label": "Done"}, for date columns use {"date": "2024-05-10"}, for text use a plain string.

Parameters

Parameter	Type	Required	Description
boardId	`number`	Yes	The ID of the board to create the item on.
name	`string`	Yes	The display name of the new item.
columnValues	`string`	Yes	A JSON string of initial column values. Keys are column IDs, values are type-specific. Examples: `{"text_col": "hello"}`, `{"status_col": {"label": "Done"}}`, `{"date_col": {"date": "2024-05-10"}}`, `{"email_col": "[email protected]"}`.
groupId	`string`	No	The ID of the group to add the item to. Defaults to the board's top group if not specified.
parentItemId	`number`	No	The ID of a parent item to create this as a sub-item under.
duplicateFromItemId	`number`	No	The ID of an existing item to duplicate as the base. Only provide when duplicating an item.

Example

Create an item with a status column value on board 18412502536:

{
  "boardId": 18412502536,
  "name": "Design homepage mockup",
  "columnValues": "{\"color_mm37gbqg\": {\"label\": \"Working on it\"}}"
}

The tool returned item ID 11971936030, the item name, a direct URL, and the board ID.

Programmatic equivalent

Use the GraphQL API to achieve the same result:

mutation {
  create_item(
    board_id: 18412502536
    item_name: "Design homepage mockup"
    column_values: "{\"color_mm37gbqg\": {\"label\": \"Working on it\"}}"
  ) {
    id
    name
    url
  }
}

For full documentation, see Items — Create an Item.