Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node interacts with the Tallyfy workflow automation platform to manage groups among other resources. Specifically, the "Group" resource with the "Get Many" operation allows users to retrieve multiple groups from their Tallyfy organization. It supports filtering, sorting, and limiting the number of results returned.

Common scenarios where this node is beneficial include:

  • Fetching a list of all groups in an organization for reporting or synchronization purposes.
  • Searching for groups by name, status, or tags to automate workflows based on group membership.
  • Retrieving groups sorted by creation or update date to process recent changes.

Practical example:

  • An automation that periodically fetches all active groups to update access permissions in another system.
  • A workflow that searches groups by specific tags to trigger notifications or assign tasks accordingly.

Properties

Name Meaning
Return All Whether to return all matching groups or only up to a specified limit.
Limit Maximum number of groups to return if not returning all (minimum 1, maximum 100).
Filters Collection of filters to refine the search:
- Search Text query to search groups by name or other attributes.
- Status Filter groups by their status. Options: Active, Completed, Archived, Draft.
- Tags Filter groups by comma-separated tags.
- Sort By How to sort the results. Options include Created Date (Newest/Oldest), Updated Date (Newest/Oldest), Name (A-Z/Z-A).

Output

The output is an array of JSON objects representing groups retrieved from Tallyfy. Each object contains the group's data as returned by the Tallyfy API, including fields such as group ID, name, description, members, guests, status, creation and update timestamps, and any other metadata provided by the API.

If "Return All" is enabled, the node will paginate through all available pages to return the complete list of groups.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • The node uses the base URL https://go.tallyfy.com/api or a custom base URL if configured in credentials.
  • Requires the organization ID to scope API requests to the correct Tallyfy organization.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect organization ID may result in empty responses or authorization errors.
    • Exceeding API rate limits can cause request failures; consider enabling "Return All" carefully.
    • Providing invalid filter values (e.g., unsupported status) may lead to no results or errors.

  • Error messages:

    • Authentication errors typically indicate problems with the API key or token.
    • HTTP 404 errors may mean the organization or resource does not exist.
    • Validation errors occur if required parameters are missing or malformed.

  • Resolutions:

    • Verify API credentials and organization ID are correctly set.
    • Check filter values against allowed options.
    • Use the "Limit" property to restrict the number of results if encountering timeouts or rate limits.
    • Enable "Continue On Fail" in n8n to handle partial failures gracefully.

Links and References

Discussion