Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Overview

This node operation allows you to create a new team within a specified group. It is useful in scenarios where you need to organize users or resources into hierarchical teams under a group structure, such as managing departments within a company or project teams within an organization. For example, you might use this node to programmatically add a new marketing team under the "Marketing" group in your system.

Properties

Name Meaning
Group Id Identifier of the Group under which the new team will be created.
Name Name of the Team to be created.
External Id Unique identifier of the Team in an external system, useful for integration purposes.
Parent Id Unique identifier of the parent team if this new team is a sub-team (nested under another team).

Output

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

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests.
  • Depends on the external API endpoint that manages groups and teams.
  • The base URL for the API must be set in the node credentials or environment configuration.

Troubleshooting

  • Missing or invalid Group Id: The operation requires a valid group identifier; ensure it is provided and correct.
  • Authentication errors: Verify that the API key or authentication token is correctly configured and has sufficient permissions.
  • Invalid Parent Id: If specifying a parent team, confirm that the parent ID exists and belongs to the same group.
  • API response errors: Check the API documentation for error codes related to team creation, such as duplicate names or invalid fields.
  • Network issues: Ensure connectivity to the API endpoint and that no firewall or proxy blocks the request.

Links and References

  • Refer to the external API documentation for detailed information about the team creation endpoint and required fields.
  • Consult n8n documentation on how to configure API credentials and handle HTTP request nodes.

Discussion