Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Account Teams → Create A Team

AI-generated

Overview

This node operation creates a new team within a specified account. It is useful in scenarios where you want to programmatically organize users or resources into teams under an account structure, such as managing departments, project groups, or functional units in a business system. For example, when onboarding a new project, you might create a dedicated team with a unique name and optionally link it to a parent team or external system identifier.

Properties

Name Meaning
Account Id Identifier of the account under which the team will be created.
Name Name of the team to be created.
External Id Unique identifier of the team in an external system, allowing cross-system references.
Parent Id Unique identifier of the parent team, enabling hierarchical team structures.

Output

The node outputs JSON data representing the newly created team object returned by the API. This typically includes the team's identifiers, name, and any metadata provided by the service. The output does not include binary data.

Dependencies

  • Requires an API key credential for authentication with the external service.
  • Needs the base URL of the API configured in the credentials.
  • Depends on the external API endpoint that manages accounts and teams.

Troubleshooting

  • Missing Required Fields: If "Account Id" or "Name" is missing, the API will likely reject the request. Ensure these fields are provided.
  • Invalid Parent Id: Providing a non-existent parent team ID may cause errors or unexpected behavior.
  • API Authentication Errors: Verify that the API key credential is correctly set up and has sufficient permissions.
  • Network Issues: Check connectivity to the API base URL.
  • Duplicate External Id: If the external ID must be unique, reusing it may cause conflicts.

Links and References

  • Refer to the external API documentation for detailed information about team creation endpoints and required parameters.
  • Consult n8n documentation on how to configure API key credentials and use HTTP request nodes if needed.

Discussion