Actions29
- Board Actions
- Item Actions
- Update Actions
- Team Actions
- User Actions
- Query Actions
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 functionality is useful for automating task or project management workflows where new tasks or subtasks 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 a parent task to break down work hierarchically.
- Populating boards with structured data from other systems.
For example, you could use this node to create a new item named "Design Review" in the "Marketing Campaign" group of a specific Monday.com board, optionally setting column values such as status or due date.
Properties
| Name | Meaning |
|---|---|
| Workspace Name or ID | Select the workspace where the board resides. 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 a list or specify an ID via expression. |
| Is Subitem | Boolean flag indicating whether the item to create is a subitem (child item) under a parent item. |
| Parent Item Name Or ID | If creating a subitem, specify the parent item's name or ID. Choose from a list or specify an ID via expression. |
| Group Name or ID | The group within the selected board where the new item will be created. Choose from a list or specify an ID via 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 which column to update. - New Value: the value to assign to that column, as a string. |
Output
The node outputs JSON data representing the result of the creation operation. Specifically, it returns the newly created item's ID inside a JSON object, e.g.:
{
"id": "123456"
}
This allows subsequent nodes in the workflow to reference the created item by its ID for further operations.
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 access the specified workspace and board.
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.
- Missing Required Parameters: Errors occur if required fields like workspace, board, group, or item name are not provided. Verify all mandatory inputs are set.
- Invalid IDs: Specifying incorrect or non-existent workspace, board, group, or parent item IDs will cause failures. Use the provided dropdowns or valid expressions to ensure correctness.
- Permission Denied: The API key must have sufficient permissions to create items in the target board. Check Monday.com user roles and API token scopes.
- Column Values Formatting: Column values must be provided as strings matching the expected format for each column type. Incorrect formatting may cause errors or unexpected results.
Links and References
This summary focuses on the "Item" resource and the "Create an Item" operation as requested, based on static analysis of the provided source code and property definitions.