Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

The node enables interaction with Monday.com teams, specifically allowing retrieval of detailed information about a specific team. This operation is useful when you want to fetch the members and metadata of a particular team within your Monday.com workspace.

Common scenarios include:

  • Automating workflows that require team member data for notifications or assignments.
  • Integrating Monday.com team details into other systems or dashboards.
  • Validating team membership before performing further actions in Monday.com.

For example, you might use this node to get all users in a team before sending them a custom email notification or syncing team members with another collaboration tool.

Properties

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

Output

The output JSON contains the detailed information 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 their id, name, and email.

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 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 in n8n.
  • Invalid Team ID: Providing an invalid or non-existent team ID will result in no data or errors. Verify the team ID or select from the provided options.
  • Network Issues: Connectivity problems to the Monday.com API endpoint can cause request failures. Check network access and proxy settings if applicable.
  • Permission Errors: The API key used must have sufficient permissions to read team data; otherwise, authorization errors may occur.

Links and References

Discussion