Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Group Teams → Create A Team

AI-generated

Overview

This node operation creates a new team within a specified group. It is useful in scenarios where you need to programmatically organize users or resources into teams under a group structure, such as managing organizational units, project teams, or departments in an external system. For example, when onboarding new projects, you can automatically create corresponding teams inside a group to streamline access control and collaboration.

Properties

Name Meaning
Group Id Identifier of the Group in which the team will be created.
Name Name of the Team to be created.
External Id Unique identifier of the Team in the external system, useful for synchronization purposes.
Parent Id Unique identifier of the parent team, allowing hierarchical team structures.

Output

The node outputs JSON data representing the newly created team object returned from the API. This typically includes details such as the team's unique ID, name, external ID, parent ID (if any), and other metadata provided by the service. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • The base URL for the API must be configured in the node credentials.
  • The node sends HTTP requests with JSON payloads to the external API endpoint responsible for team creation.

Troubleshooting

  • Missing Required Fields: Ensure that the "Group Id" property is provided; it is mandatory.
  • Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Invalid Parent Id: If specifying a "Parent Id", confirm that it exists and belongs to the same group.
  • API Endpoint Issues: Check network connectivity and the correctness of the base URL configuration.
  • Error Responses: The node may throw errors if the external API rejects the request due to invalid data or server issues. Review error messages for details and adjust input properties accordingly.

Links and References

  • Refer to the external API documentation for detailed information on team creation endpoints and required fields.
  • n8n documentation on creating custom nodes and handling API credentials.

Discussion