Payhawk icon

Payhawk

Interact with the Zitadel API

Actions99

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 to sync team structures.
  • Auditing team memberships for compliance or reporting purposes.

Properties

Name Meaning
Account Id Identifier of the account whose team records you want to list

Output

The output will be a JSON array containing the team records associated with the specified account. Each item in the array represents a team record with its details (such as team name, ID, members, etc., depending on the API response structure).

If the node supports binary data output, it would typically relate to attachments or files linked to team records, but based on the provided code and context, this node outputs only JSON data representing team information.

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 API endpoint that provides team data for accounts.
  • Proper base URL configuration and network access to the API are necessary.

Troubleshooting

  • Missing or invalid Account Id: Ensure the "Account Id" property is correctly set and corresponds to an existing account; otherwise, the API may return errors or empty results.
  • Authentication errors: Verify that the API credentials are valid and have sufficient permissions to read team data.
  • Network issues: Check connectivity to the API endpoint and ensure no firewall or proxy blocks the requests.
  • API rate limits: If many requests are made in a short time, the API might throttle or block calls; implement retry logic or respect rate limits.

Common error messages might include:

  • Unauthorized or 401 errors indicating invalid credentials.
  • 404 Not Found if the account ID does not exist.
  • 500 Internal Server Error if the API has issues; retry later or contact support.

Links and References

  • Refer to the external API documentation for detailed schema of team records and account management.
  • n8n documentation on how to configure API credentials and use HTTP request nodes for custom integrations.

Discussion