Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

Overview

The node "Worktables" integrates with Monday.com via its GraphQL API to perform various operations on different resources such as boards, items, updates, teams, and users. Specifically for the Team resource and the Get a Team operation, this node retrieves detailed information about a specific team, including its ID, name, and the list of users belonging to that team.

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.

Practical example:
You can use this node to get the members of a particular team by specifying the team's name or ID, then use that data to send notifications, update CRM records, or manage permissions in other integrated tools.

Properties

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

Output

The output JSON contains the full details of the requested team, structured as follows:

{
  "teams": [
    {
      "id": "team_id",
      "name": "team_name",
      "users": [
        {
          "id": "user_id",
          "name": "user_name",
          "email": "user_email"
        },
        ...
      ]
    }
  ]
}
  • id: The unique identifier of the team.
  • name: The name of the team.
  • users: An array of user objects who are members of the team, each containing:
    • id: User's unique identifier.
    • name: User's display name.
    • email: User's email address.

No binary data is output by 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 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 Team ID or Name:
    If the specified team does not exist or the ID is incorrect, the API will return an empty result or an error. Verify the team selection or expression used.

  • Network or Permission Issues:
    Network connectivity problems or insufficient permissions associated with the API key may cause request failures. Confirm network access and that the API key has adequate scopes/permissions to read team data.

  • Malformed Query Errors:
    Since the node constructs GraphQL queries dynamically, any unexpected input might cause query errors. Use valid IDs and ensure expressions resolve correctly.

Links and References

If you need summaries for other resources or operations, feel free to ask!

Discussion