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.

Use cases include:

  • Automating team creation workflows when onboarding new projects or departments.
  • Creating guest teams for external collaborators.
  • Managing team membership by specifying initial users.
  • Controlling whether empty teams are allowed.

Example: Automatically create a new project team with specified members and mark it as a guest team if needed.

Properties

Name Meaning
Team Name The name of the team to be created.
Is Guest Boolean flag indicating whether the team is a guest team (external collaborators).
Users Name or IDs List of user IDs or names to add as subscribers/members of the team.
Allow Empty Team Boolean flag indicating whether the creation of a team without any users is allowed.

Output

The output JSON contains the response from the Monday.com API after attempting to create the team. It includes at least the newly created team's id and name. For example:

{
  "data": {
    "create_team": {
      "id": "123456",
      "name": "New Team Name"
    }
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an API key credential for Monday.com (referred to as "WorktablesApi" in the code).
  • 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.

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 not accessible may cause the mutation to fail or ignore those users.
  • Empty Team Not Allowed: If allowEmptyTeam is false and no users are provided, the API might reject the request.
  • GraphQL Errors: Any syntax errors or invalid parameters in the GraphQL mutation will result in errors returned from the Monday.com API. Check the mutation string and parameter values carefully.

Links and References

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

Discussion