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 an organization or project teams within a larger group.

Practical examples include:

  • Creating a new project team inside a department group.
  • Adding a sub-team under an existing parent team for better organizational hierarchy.
  • Synchronizing external system teams by creating corresponding teams in the target system.

Properties

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

Output

The output contains a JSON object representing the newly created team. This typically includes all properties sent during creation along with any additional metadata or identifiers assigned by the system after creation.

No binary data output is expected from this operation.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to authorize requests.
  • The node interacts with an external API endpoint that manages groups and teams.
  • Proper base URL configuration for the API is necessary in the node credentials or settings.

Troubleshooting

  • Missing Required Fields: If "Group Id" is not provided, the node will likely throw an error indicating a missing required parameter.
  • Authentication Errors: Ensure that the API key or authentication token is valid and has permissions to create teams.
  • Invalid Parent Id: Providing a non-existent or incorrect "Parent Id" may cause the API to reject the request.
  • API Endpoint Issues: Network errors or incorrect base URL configurations can prevent successful team creation.

To resolve these issues:

  • Double-check all required fields are filled correctly.
  • Verify API credentials and permissions.
  • Confirm the parent team exists before assigning a parent ID.
  • Test connectivity to the API endpoint outside n8n if needed.

Links and References

  • Refer to the external API documentation for detailed information on team creation endpoints and required parameters.
  • n8n documentation on how to configure API credentials and use HTTP request nodes for custom integrations.

Discussion