Worktables icon

Worktables

Interact with Monday.com boards and items

Overview

The node "Worktables" integrates with Monday.com to perform various operations on different resources such as boards, items, updates, teams, and users. Specifically for the Team resource with the Get a Team operation, it retrieves detailed information about a specific team, including its ID, name, and the list of users belonging to that team (with each user's ID, name, and email).

This node is beneficial in scenarios where you want to automate workflows involving team management on Monday.com, such as fetching team details for reporting, synchronizing team data with other systems, or triggering actions based on team membership.

Example use case:
You want to get the details of a particular team by selecting it from a dropdown or specifying its ID dynamically, then use this information downstream in your workflow to notify team members or update another system.

Properties

Name Meaning
Team Name or ID (team) Select a team from a list loaded dynamically or specify a team ID using an expression. This identifies which team's details to retrieve.

Output

The output JSON structure for the Get a Team operation contains the following fields:

  • id: The unique identifier of the team.
  • name: The name of the team.
  • users: An array of user objects who belong to the team. Each user object includes:
    • id: User's unique identifier.
    • name: User's full name.
    • email: User's email address.

The output is returned as an array of items, each with a json property containing the parsed response from Monday.com's API.

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for Monday.com (referred generically as an API authentication token).
  • The node makes HTTP POST requests to the Monday.com GraphQL API endpoint: https://api.monday.com/v2.
  • Proper configuration of the API key credential in n8n is necessary for authentication.

Troubleshooting

  • API Key Not Found Error:
    If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the API key is correctly set up in n8n credentials.

  • Invalid Team ID or Empty Selection:
    If the team parameter is empty or invalid, the query will fail. Make sure to select a valid team from the dropdown or provide a correct team ID via expression.

  • Network or Permission Issues:
    Errors related to network connectivity or insufficient permissions on the Monday.com account may occur. Verify network access and that the API key has sufficient rights to read team data.

  • Malformed Query or Unexpected Response:
    Since the node constructs GraphQL queries dynamically, any unexpected changes in the Monday.com API schema could cause errors. Check the API documentation if issues arise.

Links and References


This summary focuses exclusively on the Team resource and the Get a Team operation as requested, based on static analysis of the provided source code and properties.

Discussion