Actions26
- Board Actions
- Docs Actions
- Folder Actions
- Group Actions
- Item Actions
- Updates Actions
- Users Actions
Overview
This node operation creates a new item on a specified board in Monday.com. It allows users to define the item's name and set values for its columns either by entering JSON directly (advanced mode) or by configuring each column individually with appropriate input fields (column-by-column mode). Additionally, it supports creating the item as a sub-item of another existing item.
Common scenarios:
- Automating task creation in project management boards.
- Adding new entries with detailed column data without manual input.
- Creating hierarchical structures by adding sub-items under parent items.
Practical example:
- Automatically create a new task item named "Design Review" on a specific board, setting its status to "In Progress" and assigning team members via people columns.
- Create a sub-item under an existing item to track subtasks or dependencies.
Properties
| Name | Meaning |
|---|---|
| Column Input Mode | How to input column values: - Advanced (JSON): Enter column values as a JSON object. - Column by Column: Add and configure columns one by one using dedicated input fields. |
| Board | The Monday.com board where the new item will be created. |
| Item Name | The name/title of the new item to create. |
| Create as Sub-Item | Whether to create this item as a sub-item of another existing item (true or false). |
| Parent Item | The parent item ID under which the new sub-item will be created. Required if "Create as Sub-Item" is enabled. |
| Column Values (JSON) | Column values provided as a JSON object. Used only when "Column Input Mode" is set to "Advanced (JSON)". Example format: {"status": {"label": "Done"}, "text": "Hello"} |
| Column Values | Collection of columns configured one by one. Used only when "Column Input Mode" is set to "Column by Column". Supports multiple column types such as Status, Dropdown, People, Board Relation, Timeline, Text, Number, Date, Checkbox, and Free text/JSON columns. Each column type has specific fields to select the column and set its value(s). |
| โน๏ธ How to Use Column Values | A notice explaining how to use the "Column by Column" mode effectively, including tips on adding columns and loading options automatically from Monday.com. |
| File Upload Notice | A notice describing the special handling required for uploading files to Monday.com, recommending using Advanced mode with JSON and uploading files first to external storage services to get public URLs. |
Output
The output is an array of JSON objects representing the newly created item or sub-item. The structure includes all relevant details returned by the Monday.com API about the created item, such as its ID, name, and column values.
If the item is created as a sub-item, the output reflects the sub-item's data.
No binary data output is produced by this operation.
Dependencies
- Requires an API authentication token credential for Monday.com.
- Uses Monday.com API version defaulting to "2023-10" unless overridden.
- Relies on Monday.com boards and their columns being accessible via the API.
- For "Column by Column" mode, dynamic loading of board columns and their possible values is used.
- File uploads require external file hosting (e.g., S3, Dropbox) and must be handled via Advanced JSON mode.
Troubleshooting
- Invalid board or column IDs: Ensure the selected board and columns exist and are accessible with the provided API credentials.
- Incorrect JSON format in Advanced mode: If the JSON for column values is malformed, parsing errors will occur. Validate JSON syntax before submission.
- Missing required fields: For sub-item creation, the parent item must be specified; otherwise, the operation will fail.
- File upload issues: Files cannot be uploaded directly; they must be hosted externally and referenced by URL in Advanced mode.
- API rate limits or permission errors: Verify that the API token has sufficient permissions and that usage does not exceed Monday.com's API limits.
- Empty or missing column values: If no column values are provided, the item will be created with just the name; ensure necessary columns are set as needed.