Worktables

Overview

This node interacts with Monday.com teams, specifically allowing management of team memberships. The "Remove Users From Team" operation enables users to remove one or more specified users from one or multiple teams within a Monday.com account.

Common scenarios where this node is beneficial include:

• Automating team membership cleanup when users leave projects or organizations.
• Managing access control by dynamically updating team compositions based on workflow triggers.
• Synchronizing team memberships with external systems or HR databases.

For example, after an employee offboarding process, this node can be used to automatically remove the user from all relevant project teams in Monday.com, ensuring they no longer have access.

Properties

Output

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

• successful_users: List of users successfully removed, each with their name and email.
• failed_users: List of users for whom removal failed, each with their name and email.

Example output structure (simplified):

{
  "remove_users_from_team": {
    "successful_users": [
      { "name": "User A", "email": "usera@example.com" }
    ],
    "failed_users": [
      { "name": "User B", "email": "userb@example.com" }
    ]
  }
}

This allows workflows to handle success and failure cases accordingly.

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 permissions on the API token are necessary to manage teams and users.

Troubleshooting

• 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 non-existent or unauthorized team/user IDs may cause partial or complete failure in removing users. Verify that the IDs are correct and accessible by the API token.
• Permission Errors: Insufficient permissions on the API token can lead to errors when attempting to modify team memberships. Confirm the token has appropriate scopes.
• Empty Inputs: Omitting required inputs like team IDs or user IDs will cause the mutation to fail. Always provide valid selections or expressions.

Links and References

• Monday.com GraphQL API Documentation
• n8n Expressions Documentation
• Monday.com Teams API Reference (general reference; actual mutations used are visible in the node code)

This summary focuses exclusively on the "Team" resource and the "Remove Users From Team" operation as requested.