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, assign tasks, or audit team structures within an organization.

Practical examples include:

  • Fetching all teams under a customer account to synchronize with an internal CRM.
  • Listing teams for reporting or access control purposes.
  • Integrating team data into dashboards or other workflow automations.

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 related to the specified account. Each item in the array represents a team and includes its details as returned by the API. The exact structure depends on the external service's response but typically includes team identifiers, names, roles, and possibly member lists.

If the node supports binary data output, it would generally relate to attachments or files linked to teams, but this operation primarily returns JSON data.

Dependencies

  • Requires an API key credential or similar authentication token configured in n8n to access the external service.
  • The node depends on the external API endpoint that provides team data for accounts.
  • Proper base URL and headers must be set up in the node credentials or configuration.

Troubleshooting

  • Missing or invalid Account Id: Ensure the "Account Id" property is provided and correctly formatted; otherwise, the API call will fail.
  • Authentication errors: Verify that the API key or authentication token is valid and has permissions to read team data.
  • API rate limits or connectivity issues: Network problems or exceeding API limits can cause failures; check logs and retry policies.
  • Unexpected response format: If the API changes, the node might not parse the response correctly; verify the API documentation and update the node if needed.

Links and References

  • Refer to the external API documentation for detailed information about the account teams endpoint.
  • n8n documentation on creating and configuring API credentials.
  • General REST API best practices for handling pagination and error responses (if applicable).

Discussion