Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

Account Teams → List All Team Records Within An Account

AI-generated

Overview

This node operation retrieves all team records associated with a specific account. It is useful when you need to list or manage the teams that belong to an account, for example, to display team members, audit team assignments, or synchronize team data with other systems.

Practical examples include:

  • Fetching all teams within a customer account to display in a dashboard.
  • Integrating with external HR or project management tools by exporting team structures.
  • Automating notifications or permissions based on team membership within an account.

Properties

Name Meaning
Account Id Identifier of the account whose teams are to be listed

Output

The output contains a JSON array of team records related to the specified account. Each item in the array represents a team and includes details such as team identifiers, names, and possibly other metadata depending on the API response structure.

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

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service's API.
  • The node depends on the external service's REST API endpoint that provides team data for accounts.
  • Proper base URL configuration and network access to the API endpoint are necessary.

Troubleshooting

  • Missing or invalid Account Id: Ensure the "Account Id" property is provided and correctly formatted; otherwise, the API call will fail or return no results.
  • Authentication errors: Verify that the API key or authentication credentials are correctly set up and have sufficient permissions to read team data.
  • Network issues: Check connectivity to the external API endpoint.
  • Empty results: If no teams are returned, confirm that the account actually has teams assigned and that the account ID is correct.

Common error messages might include unauthorized access, resource not found, or bad request due to missing parameters. Resolving these usually involves checking credentials, input values, and API endpoint availability.

Links and References

  • Refer to the external service’s official API documentation for detailed information about the "List All Team Records Within An Account" endpoint.
  • n8n documentation on how to configure API credentials and use HTTP Request nodes may also be helpful.

Discussion