Worktables icon

Worktables

Interact with Monday.com boards and items
Join our community

Actions126

Overview

This node operation creates a new item or subitem in a specified Monday.com board. It allows users to specify the board, group, item name, and whether the item is a subitem. Users can also provide column values with various data types (e.g., text, date, people, files) to set detailed attributes for the new item. The node handles the construction of the appropriate GraphQL mutation to create the item and fetches the created item's details for output.

Use Case Examples

  1. Create a new task item in a project management board with specific column values like status, due date, and assigned people.
  2. Add a subitem under a parent item to track subtasks or detailed steps within a larger task.
  3. Create an item with file attachments linked to specific columns for documentation purposes.

Properties

Name Meaning
Board The Monday.com board where the item will be created. This is a required selection or expression input.
Is Subitem? Boolean flag indicating whether the item to create is a subitem of another item.
Group The group within the selected board where the item will be created. Required if the item is not a subitem.
Item Name The name/title of the item to be created.
Parent Item If creating a subitem, this specifies the parent item's ID. Should be left blank if not a subitem.
Column Values A collection of column-specific values to set on the item. Supports multiple data types including text, date, people, files, links, and more.

Output

JSON

  • id - The unique identifier of the created item.
  • name - The name of the created item.
  • url - The URL link to the created item in Monday.com.
  • board
    • id - The ID of the board where the item was created.
  • column_values - An object containing the values of the columns for the created item, keyed by column ID.
  • parent_item
    • id - If the item is a subitem, the ID of its parent item.

Dependencies

  • Monday.com API accessed via an API key credential

Troubleshooting

  • Ensure the API key credential is correctly configured and has permissions to create items on the specified board.
  • Verify that the board ID, group ID, and parent item ID (if subitem) are valid and accessible.
  • Column values must be correctly formatted according to their types; invalid JSON or unsupported formats will cause errors.
  • If creating a subitem, the parent item ID must be provided; otherwise, the operation will fail.
  • Check for API rate limits or errors returned by Monday.com API and handle them appropriately in the workflow.

Links

Discussion