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 workflow, such as managing user groups, permissions, or collaboration settings based on external team structures.

For example, you might use this node to fetch all 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. This typically includes details such as team names, IDs, and possibly other metadata related to each external team. The exact structure depends on the external API's response but generally provides a list or array of team objects.

No binary data output is indicated.

Dependencies

  • Requires an API key or authentication token configured in the node credentials to access the external service.
  • The node interacts with an external API endpoint (base URL provided via credentials).
  • Proper network connectivity to the external API is necessary.

Troubleshooting

  • Common issues:

    • Invalid or missing Account Id: Ensure the Account Id property is correctly set and corresponds to an existing account.
    • Authentication errors: Verify that the API key or authentication credentials are valid and have sufficient permissions.
    • Network errors: Check internet connectivity and firewall settings that may block access to the external API.
  • Error messages:

    • Unauthorized or 401 errors indicate invalid credentials; reconfigure the API key.
    • 404 errors may mean the Account Id does not exist or the resource is unavailable.
    • Timeout errors suggest network issues or slow API responses; consider retrying or increasing timeout settings.

Links and References

  • Refer to the external API documentation for detailed information about the "External Teams" endpoint and its response schema.
  • n8n documentation on how to configure API credentials and handle HTTP request nodes.

Discussion