New Monday Item

The New Monday Item node allows the workflow to create a new item (or subitem) in a specified Monday.com board. This action uses a configured service account for API authentication and supports dynamic column updates.

---

🧩 Node Type

Task

---

⚙️ Task Type

New Monday Item

---

🎯 Purpose

Creates a new item or subitem in a Monday.com board within a specified group. Optionally allows setting values for item columns via JSON input. Common use cases include:

• Automating creation of Monday.com tasks or tickets.
• Populating items based on workflow data.
• Creating structured subitems under a parent task.

---

📝 Required Fields

These inputs must be configured in the node's modal form:

Label	Type	Description
Board Id	Text	The numerical ID of the Monday.com board. Must be valid.
Group Name	Text	The display name of the target group within the board.
Item Name	Text	The name/title of the item or subitem to be created.

---

🧩 Optional Inputs

Label	Type	Description
Parent Item Id	Text	If specified, a subitem will be created under this parent item. Must be a valid numeric ID.
Column Values	JSON	JSON string of key-value pairs representing column updates. Keys must match column IDs on the board. Example: { "status": { "label": "Done" }, "date4": { "date": "2025-06-30" } }
ServiceAccount-Monday	Text	The internal service account ID used to authenticate to Monday.com. This must be pre-configured in the system.

---

🧪 Output Variables

Variable	Description
MondayItem	Dictionary representing the created item (if not a subitem).
MondaySubItem	Dictionary representing the created subitem (if a parent item was provided).

---

🧠 Logic Overview

1. Validation: Ensures Board Id, Group Name, and Item Name are present.

2. Authentication: Uses the supplied ServiceAccount-Monday to retrieve the API key.

3. Board/Group Lookup: Retrieves the board and searches for the group by name.

4. Item Creation:

   • If Parent Item Id is provided, creates a subitem under the parent.
   • Otherwise, creates a top-level item in the specified group.

5. Column Updates: If column values are provided, the node updates the item using the Monday API.

6. Returns: The created item is returned in the output for downstream use.

---

⚠️ Error Handling

If any of the following conditions fail, the task will return taskSuccess = false and set statusReturn = "Fail":

• Invalid Board Id or Parent Item Id (non-numeric).
• Board or Group not found.
• Subitem creation fails.
• Column updates fail.

---

📌 Notes

• The Column Values field expects a properly formatted JSON string. Incorrect formatting or invalid column IDs will result in failure.
• Subitem creation and column update logic includes redundant checks and re-fetches the item after update to ensure consistency.
• Column updates support complex field types such as status, date, numbers, etc., depending on the board configuration.

---

📷 Example

Input Example

{
  "Board Id": "123456789",
  "Group Name": "Tasks",
  "Item Name": "Create Automation Step",
  "Parent Item Id": "987654321",
  "Column Values": "{ \"status\": { \"label\": \"In Progress\" }, \"priority\": { \"label\": \"High\" } }",
  "ServiceAccount-Monday": "svc-account-id-001"
}

Output Example

{
  "MondaySubItem": {
    "id": "44556677",
    "name": "Create Automation Step",
    "column_values": [
      { "id": "status", "text": "In Progress" },
      { "id": "priority", "text": "High" }
    ]
  }
}

---