Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

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 setups based on external team structures.

For example, you might use this node to fetch all teams linked to a particular account in an external service and then process or route data according to team membership.

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. Each item in the output corresponds to an external team object with its properties as returned by the external API.

If the node supports binary data output (not evident from the provided code), it would typically represent attachments or files related to the teams, but no such indication is present here.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service's API.
  • The node depends on an external API endpoint that provides external team data for a given account.
  • The base URL and headers for API requests are expected to be set via credentials or node configuration.

Troubleshooting

  • Common issues:

    • Invalid or missing Account Id will cause the API call to fail or return no data.
    • Authentication errors if the API key or token is not properly configured.
    • Network or connectivity issues preventing access to the external API.
  • Error messages:

    • "Unauthorized" or "Authentication failed": Check that the API credentials are correctly set up.
    • "Account not found" or similar: Verify the Account Id is correct and exists in the external system.
    • Timeout or network errors: Ensure the external API is reachable from the n8n environment.

Links and References

  • Refer to the external service’s API documentation for details on the "External Teams" endpoint and required parameters.
  • n8n documentation on setting up API credentials and using HTTP request nodes may help configure authentication.

Discussion