Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node interacts with the Tallyfy workflow automation platform, specifically managing "Guest" resources when performing the "Get Many" operation. It retrieves multiple guest records from a Tallyfy organization, supporting filtering, sorting, and pagination options. This is useful for scenarios where you need to list or analyze guests associated with your workflows, such as auditing guest access, exporting guest lists, or integrating guest data into other systems.

For example, you might use this node to:

  • Retrieve all active guests in your organization.
  • Search guests by name or email.
  • Sort guests by creation date or name.
  • Limit the number of guests returned for performance reasons.

Properties

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

Output

The node outputs an array of JSON objects representing guests. Each object contains the guest's details as returned by the Tallyfy API, such as email, first name, last name, status, tags, and timestamps. The exact structure depends on the API response but generally includes identifying and descriptive information about each guest.

No binary data output is produced by this operation.

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • Needs the organization ID configured within the credentials.
  • Uses the base URL https://go.tallyfy.com/api by default unless overridden in credentials.
  • Relies on HTTP requests authenticated via the provided API key.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect organization ID may result in empty responses or errors.
    • Exceeding rate limits imposed by the Tallyfy API can cause request failures.
    • 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 permissions.
    • "Not Found" errors may occur if the organization ID or resource identifiers are incorrect.
    • Validation errors can happen if input parameters like limit or filters are out of allowed ranges.

  • Resolutions:

    • Verify that the API key credential is correctly set up and has necessary permissions.
    • Confirm the organization ID matches your Tallyfy account.
    • Use valid filter values as per the property definitions.
    • Handle pagination properly if expecting large datasets.

Links and References

Discussion