Overview

This node operation retrieves multiple group records from the Hudu system. It supports fetching all groups or limiting the number of results returned. Users can apply filters such as group name, default status, or search terms to narrow down the results. Additionally, it offers an option to wrap all results into a single item containing an array of groups and a count, which helps prevent downstream nodes from executing multiple times and potentially hitting rate limits. This operation is useful for scenarios where you need to list or process multiple groups, such as syncing group data, reporting, or batch processing.

Use Case Examples

1. Fetch all groups without limit to get a complete list of groups.
2. Retrieve up to 50 groups filtered by name or default status.
3. Return all groups wrapped in a single item to optimize workflow execution and avoid rate limiting.

Properties

Output

JSON

• items - Array of group objects returned when results are wrapped in a single item.
• count - Number of group items returned when results are wrapped.

Dependencies

• Requires an API key credential for authenticating with the Hudu REST API.

Troubleshooting

• Common issues include API authentication failures due to invalid or missing credentials.
• Errors may occur if the resource or operation parameters are incorrect or unsupported.
• Rate limiting can happen if many individual group items are processed downstream; using the 'Wrap Results in Single Item' option can mitigate this.