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 various columns on that board. The node supports two modes for inputting column values: an advanced mode where column data is provided as raw JSON, and a simple mode with dynamic UI fields for common column types such as status, dropdown, people, timeline, and board relations.
Typical use cases include automating task creation, project management updates, or any workflow where new items need to be programmatically added to Monday.com boards with specific attributes set at creation time.
For example, you could create a new task item named "Prepare Report" on a project board, setting its status to "In Progress," assigning it to team members, and specifying a timeline—all within one node execution.
Properties
| Name | Meaning |
|---|---|
| Column Input Mode | How to input column values: - Advanced (JSON): Enter column values as a JSON object. - Simple (Dynamic UI): Use dynamic UI fields to select values for common column types. |
| Board | The Monday.com board where the new item will be created. |
| Item Name | The name/title of the new item to create on the board. |
| Column Values (JSON) | (Advanced mode only) JSON object representing column values to set on the new item. Example: {"status": {"label": "Done"}, "text": "Hello"} |
| Status Column | (Simple mode only) Select a status-type column on the board to update. |
| Status Value | (Simple mode only) Select the status value to assign in the chosen status column. |
| Dropdown Column | (Simple mode only) Select a dropdown-type column on the board to update. |
| Dropdown Values | (Simple mode only) Select one or more dropdown options to assign in the chosen dropdown column. |
| People Column | (Simple mode only) Select a people-type column on the board to update. |
| People | (Simple mode only) Select users or guests to assign in the chosen people column. |
| Board Relation Column | (Simple mode only) Select a board relation-type column on the board to update. |
| Related Items | (Simple mode only) Select linked items from the related board to assign in the chosen board relation column. |
| Timeline Column | (Simple mode only) Select a timeline-type column on the board to update. |
| Timeline Start Date | (Simple mode only) Set the start date for the timeline column. |
| Timeline End Date | (Simple mode only) Set the end date for the timeline column. |
| File Upload Notice | Informational notice explaining that file uploads require special handling via Advanced mode using JSON and external storage URLs. |
Output
The node outputs an array of JSON objects, each representing the newly created item returned by the Monday.com API. The JSON structure includes details about the created item such as its ID, name, and column values as returned by the API.
If multiple items are created (e.g., when processing multiple inputs), each output entry corresponds to one created item.
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 in credentials.
- Relies on Monday.com API endpoints to create items and set column values.
- For simple mode, dynamically loads board metadata such as available boards, columns, users, and linked items via helper methods.
- File uploads are not directly supported in simple mode; require uploading files externally and referencing them via URLs in advanced JSON mode.
Troubleshooting
- Invalid JSON in Advanced Mode: If the JSON entered in "Column Values (JSON)" is malformed, the node will throw a parsing error. Ensure valid JSON syntax.
- Missing Required Fields: The "Board" and "Item Name" fields are mandatory. Omitting these will cause errors.
- Incorrect Column IDs or Values: Using invalid or mismatched column IDs or values may result in API errors. Verify column selections and values correspond to the target board's schema.
- File Uploads Not Working: Attempting to upload files via simple mode will fail. Follow the instructions in the file upload notice: upload files to an external service first, then reference their public URLs in advanced JSON mode.
- API Authentication Errors: Ensure the API token credential is valid and has sufficient permissions to create items on the specified board.
- Rate Limits or API Downtime: Monday.com API rate limits or outages can cause failures. Retry after some time or check Monday.com's status page.