Worktables icon

Worktables

Interact with Monday.com boards and items

Actions29

Overview

The node enables interaction with teams in a Monday.com environment via the Monday.com API. Specifically, for the Team resource and the Create a Team operation, it allows users to create a new team by specifying its name, whether it is a guest team, which users belong to it, and whether empty teams are allowed.

This node is beneficial when automating team management workflows, such as dynamically creating teams based on project needs or onboarding processes. For example, you could automatically create a new team for a project and assign relevant users to it without manual intervention.

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 (true) or not (false).
Users Name or IDs List of user IDs to add as subscribers to the team. Users can be selected from a list or specified via expression.
Allow Empty Team Boolean flag indicating whether creation of a team without any users is allowed (true) or not (false).

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. The structure looks like:

{
  "data": {
    "create_team": {
      "id": "123456",
      "name": "Example Team"
    }
  }
}

No binary data output is involved in this operation.

Dependencies

  • Requires an active Monday.com API key credential configured in n8n.
  • Uses Monday.com GraphQL API endpoint: https://api.monday.com/v2.
  • The node sends a GraphQL mutation to create the team.

Troubleshooting

  • API Key Not Found: If the API key credential is missing or invalid, the node will throw an error. Ensure that the Monday.com 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 API call to fail or ignore those users. Verify user IDs before use.
  • Empty Team Not Allowed: If Allow Empty Team is false and no users are provided, the API might reject the request. Either provide users or enable allowing empty teams.
  • GraphQL Syntax Errors: Malformed input values (e.g., special characters in team names) might cause errors. Use proper escaping or validation.

Links and References

Discussion