Worktables icon

Worktables

Interact with Monday.com boards and items

Actions26

Overview

This node integrates with Monday.com (referred to as "Worktables" in the code) and allows users to perform various operations on different resources such as boards, items, updates, teams, and users. Specifically for the Team resource and the Create a Team operation, the node enables creating a new team within Monday.com.

Creating a team is useful for organizing users into groups for collaboration, managing permissions, or segmenting workspaces. For example, you might create a marketing team including all marketing members or a guest team for external collaborators.

The node sends a GraphQL mutation request to Monday.com's API to create the team with specified properties like team name, guest status, user membership, and whether empty teams are allowed.

Properties

Name Meaning
Team Name The name of the team to be created.
Is Guest Boolean flag indicating if the team is a guest team (external collaborators).
Users Name or IDs List of users to add to the team. Users can be selected from a list or specified by ID expressions.
Allow Empty Team Boolean flag specifying whether creating a team without any users is allowed.

Output

  • The output JSON contains the response from Monday.com's API after attempting to create the team.
  • Typically, it includes the newly created team's id and name.
  • Example output structure:
{
  "data": {
    "create_team": {
      "id": "123456",
      "name": "Marketing Team"
    }
  }
}
  • No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for Monday.com (referred to 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 configuration of the API key in n8n credentials is necessary for authentication.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error stating "API Key not found". Ensure the API key is correctly set up in n8n credentials.
  • Invalid User IDs: Providing user IDs that do not exist or are malformed may cause the API to reject the request. Verify user IDs before use.
  • Empty Team Not Allowed: If Allow Empty Team is false and no users are provided, the API may reject the creation. Either provide users or enable allowing empty teams.
  • GraphQL Errors: Any syntax errors or invalid parameters in the mutation query will result in API errors. Review the input parameters carefully.
  • Network Issues: Connectivity problems to the Monday.com API endpoint will cause request failures. Check network access and proxy settings if applicable.

Links and References

This summary focuses on the Team - Create a Team operation extracted from the provided source code and property definitions.

Discussion