Worktables

Overview

This node integrates with a project management platform (Monday.com) to manage teams and their memberships. Specifically, the "Add Users to Team" operation allows you to add one or more users to one or multiple teams within your Monday.com account.

Common scenarios where this node is beneficial include:

• Automating team membership updates when new employees join or change roles.
• Synchronizing user groups from other systems into Monday.com teams.
• Managing access control by programmatically adding users to relevant teams based on workflow triggers.

For example, after onboarding a new employee in an HR system, you can use this node to automatically add that user to specific project teams in Monday.com, ensuring they have immediate access to necessary resources.

Properties

Both properties support selecting from a list loaded dynamically from Monday.com or specifying IDs via expressions.

Output

The output JSON contains the result of the mutation request to add users to teams. It includes two main arrays:

• successful_users: List of users successfully added to the team(s), each with their name and email.
• failed_users: List of users for whom the addition failed, also including name and email.

Example output structure (simplified):

{
  "add_users_to_team": {
    "successful_users": [
      { "name": "User One", "email": "userone@example.com" },
      { "name": "User Two", "email": "usertwo@example.com" }
    ],
    "failed_users": [
      { "name": "User Three", "email": "userthree@example.com" }
    ]
  }
}

No binary data output is involved in 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 (https://api.monday.com/v2).
• Proper permissions are needed on the API key to manage teams and users.

Troubleshooting

Common Issues

• API Key Not Found: If the API key credential is missing or invalid, the node will throw an error indicating the API key was not found. Ensure the credential is configured correctly in n8n.
• Invalid Team or User IDs: Providing incorrect or non-existent team or user IDs will cause the mutation to fail for those entries, reflected in the failed_users output.
• Insufficient Permissions: The API key must have sufficient permissions to modify team memberships; otherwise, mutations will fail.
• Empty Input Arrays: If no teams or users are specified, the mutation may fail or do nothing. Always ensure at least one team and one user is selected.

Error Messages

• "API Key not found": Check that the API key credential is set up and linked properly.
• "Unsupported operation" or "Unsupported resource": Indicates a misconfiguration in the node parameters; verify that the Resource is set to "Team" and Operation to "Add Users to Team".
• GraphQL errors related to invalid IDs or permissions will be returned from the Monday.com API and surfaced by the node.

Links and References

• Monday.com GraphQL API Documentation
• n8n Expressions Documentation
• Monday.com Teams API Reference

This summary is based solely on static analysis of the provided source code and property definitions without runtime execution.