Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

External Teams → Get External Teams

AI-generated

Overview

This node operation, "Get External Teams," retrieves a list of external teams associated with a specified account. It is useful in scenarios where you need to integrate or synchronize team data from an external system into your workflows, such as managing user groups, permissions, or collaboration settings based on external team structures.

For example, you might use this node to fetch all external teams linked to a particular account before assigning tasks or sending notifications to those teams within your automation.

Properties

Name Meaning
Account Id Identifier of the account whose external teams you want to retrieve

Output

The output JSON contains the data representing the external teams fetched for the given account. Typically, this will be an array or collection of team objects, each including details such as team name, ID, and possibly other metadata related to the external teams.

If the node supports binary data output (not indicated here), it would represent any files or attachments related to the teams, but this operation primarily returns structured JSON data.

Dependencies

  • Requires an API key credential or authentication token configured in n8n to access the external service's API.
  • The node depends on the external system's API endpoint that provides external team information for a given account.
  • Proper base URL and authentication credentials must be set up in n8n for successful API communication.

Troubleshooting

  • Common issues:
    • Invalid or missing Account Id: Ensure the Account Id property is correctly provided and corresponds to an existing account.
    • Authentication errors: Verify that the API key or authentication token is valid and has sufficient permissions.
    • Network or connectivity problems: Check network access to the external API endpoint.
  • Error messages:
    • "Unauthorized" or "Authentication failed": Indicates invalid credentials; update or reconfigure the API authentication.
    • "Account not found" or similar: The provided Account Id does not exist; verify the input value.
    • Timeout or connection errors: May require retrying or checking network/firewall settings.

Links and References

  • Refer to the external service’s API documentation for detailed information about the external teams endpoint.
  • n8n documentation on setting up API credentials and HTTP request nodes may help configure authentication properly.

Discussion