Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node enables interaction with Monday.com boards and items, specifically allowing you to create new items within a board. It is useful for automating task or project management workflows by programmatically adding new tasks (items) to specific groups on a Monday.com board. For example, you can automatically create a new item when a form is submitted or when an event occurs in another system, helping keep your Monday.com boards up-to-date without manual input.

Properties

Name	Meaning
Workspace Name or ID	Select the workspace where the board resides. You can choose from a list or specify an ID using an expression.
Board Name or ID	Select the Monday.com board where the item will be created. Choose from the list or specify an ID using an expression.
Is Subitem	Boolean flag indicating whether the item to create is a subitem of another item. If true, additional parent item options become available.
Parent Item Name Or ID	If creating a subitem, specify the parent item's name or ID. Choose from the list or specify an ID using an expression.
Group Name or ID	Select the group within the board where the item will be created. Choose from the list or specify an ID using an expression.
Item Name	The name/title of the new item to create.
Column Values	A collection of column values to set on the new item. Each entry includes: - Column Name or ID: The target column to update. - New Value: The value to assign to that column.

Output

The node outputs JSON data representing the result of the creation operation. Specifically, it returns the newly created item's ID wrapped inside a GraphQL mutation response structure. The output JSON typically looks like:

{
  "data": {
    "create_item": {
      "id": "123456"
    }
  }
}

If a subitem is created instead, the response will be under create_subitem with a similar structure.

No binary data output is produced by this operation.

Dependencies

Requires an API key credential for Monday.com (referred generically as "an API key credential").
The node makes HTTP POST requests to the Monday.com GraphQL API endpoint at https://api.monday.com/v2.
Proper configuration of the API key credential in n8n is necessary for authentication.
The workspace, board, and group must exist and be accessible with the provided API key.

Troubleshooting

API Key Not Found: The node throws an error if the API key credential is missing or invalid. Ensure the API key is correctly configured in n8n credentials.
Missing Required Parameters: Errors occur if required fields such as workspace, board, group, or item name are not provided. Double-check all mandatory inputs.
Invalid IDs: Specifying incorrect or non-existent workspace, board, group, or parent item IDs will cause the API call to fail. Use the provided dropdowns or valid expressions to ensure correctness.
Subitem Creation Issues: When creating subitems, the parent item ID must be valid and belong to the selected board; otherwise, the mutation will fail.
Column Values Formatting: Column values must be formatted as JSON strings mapping column IDs to their new values. Improper formatting may lead to errors.
API Rate Limits: Excessive requests might hit Monday.com's rate limits, causing temporary failures. Implement retries or delays if needed.