Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node integrates with Monday.com (referred to as "Worktables" in the code) and allows users to perform various operations on different resources such as boards, items, groups, teams, updates, and users. Specifically for the Item resource and the Get an Item operation, the node retrieves detailed information about a specific item by its ID.

Common scenarios where this node is beneficial include:

  • Fetching detailed data of a particular task or project item from Monday.com for further processing or reporting.
  • Integrating Monday.com item details into workflows that require up-to-date information about tasks.
  • Automating retrieval of item metadata and column values for synchronization with other systems.

Practical example:

  • You want to get all details of a Monday.com item (task) identified by its unique ID to update a CRM system or send notifications based on the item's status or properties.

Properties

Name Meaning
Item ID The unique identifier of the item to retrieve. This can be specified using an expression.

Output

The output JSON contains the full details of the requested item, including:

  • id: The unique ID of the item.
  • name: The name/title of the item.
  • created_at: Timestamp when the item was created.
  • updated_at: Timestamp when the item was last updated.
  • column_values: An array of objects representing each column's data for the item, with fields:
    • id: Column ID.
    • title: Column title.
    • text: Textual representation of the value.
    • value: Raw value in JSON string format.

Example output structure (simplified):

{
  "data": {
    "items": [
      {
        "id": "12345",
        "name": "Example Item",
        "created_at": "2023-01-01T12:00:00Z",
        "updated_at": "2023-01-02T15:30:00Z",
        "column_values": [
          {
            "id": "status",
            "title": "Status",
            "text": "Done",
            "value": "{\"index\":1}"
          },
          {
            "id": "date",
            "title": "Due Date",
            "text": "2023-01-10",
            "value": "2023-01-10"
          }
        ]
      }
    ]
  }
}

The node does not output binary data for 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.

Troubleshooting

  • API Key Not Found: If the node throws an error indicating the API key is missing, ensure that the Monday.com API key credential is correctly set up and linked to the node.
  • Invalid Item ID: Providing an invalid or non-existent item ID will result in no data or an error response. Verify the item ID exists in your Monday.com account.
  • Permission Issues: The API key used must have sufficient permissions to access the item data; otherwise, the request may fail.
  • Network or API Errors: Temporary network issues or API rate limits might cause failures. Retry after some time or check API usage limits.

Links and References

This summary focuses exclusively on the Item resource and the Get an Item operation as requested.

Discussion