Worktables icon

Worktables

Interact with Monday.com boards and items
Join our community

Actions126

Overview

This node interacts with Monday.com boards and items, specifically supporting the 'Create or Update Item' operation within the 'Item' resource. It allows users to either create a new item or subitem on a specified board or update an existing one based on a unique identifier column and value. This is useful for workflows that need to synchronize or manage Monday.com items dynamically, such as updating project tasks or adding new entries if they don't exist.

Use Case Examples

  1. Create a new item in a Monday.com board group with specified column values.
  2. Update an existing item identified by a unique column value, modifying its column values accordingly.
  3. Create a subitem under a parent item if specified, or update an existing subitem based on identifier.

Properties

Name Meaning
Board The Monday.com board where the item or subitem will be created or updated.
Is Subitem? Indicates whether the item is a subitem (child item).
Identifier Column The column used to find an existing item for update by matching the identifier value.
Identifier Value The value in the identifier column to find the item. If empty, a new item will be created.
Item Name The name of the item or subitem to create or update.
Group Name The group within the board where the item will be created (only for main items, not subitems).
Parent Item The parent item ID if creating or updating a subitem.
Column Values The values for the columns of the item or subitem, supporting various column types such as text, status, people, date, file links, etc.

Output

JSON

  • id - The unique identifier of the created or updated item.
  • name - The name of the item.
  • url - The URL link to the item in Monday.com.
  • board_id - The ID of the board where the item resides.
  • column_values - An object containing the column values of the item, keyed by column ID.
  • parent_item
    • id - The ID of the parent item if the item is a subitem.

Dependencies

  • Monday.com API
  • an API key credential for authentication

Troubleshooting

  • Ensure the API key credential is correctly configured and has the necessary permissions to access the Monday.com API.
  • Verify that the board ID, group ID, and parent item ID (for subitems) are valid and accessible.
  • When updating items, ensure the identifier column and value correctly match an existing item; otherwise, a new item will be created.
  • 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.

Links

Discussion