Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node enables interaction with Monday.com boards and items, specifically allowing users to create new items within a board. It supports creating both regular items and subitems (items nested under a parent item). This is useful for automating task or project management workflows where new tasks or entries need to be programmatically added to Monday.com boards.

Typical use cases include:

  • Automatically adding new tasks to a project board when triggered by an external event.
  • Creating subtasks under existing tasks to break down work hierarchically.
  • Populating boards with structured data including custom column values.

Properties

Name Meaning
Workspace Name or ID Select the workspace in which the board resides. You can choose from a list or specify an ID via expression.
Board Name or ID Select the Monday.com board where the item will be created. Choose from the list or specify an ID using an expression.
Is Subitem Boolean flag indicating whether the item to create is a subitem (nested under a parent item). If true, additional parent item options become available.
Parent Item Name Or ID If creating a subitem, specify the parent item's name or ID. Choose from the list or specify an ID using an expression.
Group Name or ID The group within the selected board where the new item will be created. Choose from the list or specify an ID using an expression.
Item Name The name/title of the new item to create.
Column Values Optional collection of column values to set on the new item. Each entry includes:
- Column Name or ID: select the column to update.
- New Value: the value to assign to that column.

Output

The output JSON contains the response from the Monday.com API after creating the item or subitem. Typically, it includes at least the newly created item's id. The structure looks like:

{
  "data": {
    "create_item": {
      "id": "123456789"
    }
  }
}

or if a subitem was created:

{
  "data": {
    "create_subitem": {
      "id": "987654321"
    }
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for Monday.com (referred generically as "an API key credential").
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
  • Proper permissions on the API key are necessary to create items and subitems on the specified boards.

Troubleshooting

  • API Key Not Found: The node throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
  • Board or Workspace Not Selected: Required parameters such as workspace, board, and group must be provided. Missing these will cause errors.
  • Invalid Parent Item ID: When creating a subitem, specifying a non-existent or incorrect parent item ID will cause failure.
  • Column Values Formatting: Column values must be provided as a JSON string mapping column IDs to their new values. Incorrect formatting may lead to API errors.
  • Permission Errors: The API key must have sufficient permissions to create items on the target board; otherwise, the request will fail.
  • Unsupported Operation: Using this node with operations other than "Create an Item" under the "Item" resource will throw unsupported operation errors.

Links and References

Discussion