Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node interacts with the Tallyfy workflow automation platform, specifically to manage users when using the "User" resource and the "Get Many" operation. It retrieves multiple user records from a Tallyfy organization, supporting filtering, sorting, and pagination options.

Common scenarios where this node is beneficial include:

  • Fetching a list of all users in an organization for reporting or synchronization purposes.
  • Retrieving users filtered by status or tags to target specific groups.
  • Sorting users by creation or update date to process recent changes.
  • Limiting the number of users returned to optimize performance or comply with API constraints.

Practical example:

  • An automation that syncs active users from Tallyfy into another system daily, fetching only active users sorted by newest created.

Properties

Name Meaning
Return All Whether to return all user results or only up to a specified limit.
Limit Maximum number of user results to return (1 to 100). Only used if "Return All" is false.
Filters Collection of filters to refine the user search:
- Search Text query to search users by name or other attributes.
- Status Filter users by their status. Options: Active, Completed, Archived, Draft.
- Tags Filter users 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 user data retrieved from Tallyfy. Each item corresponds to one user and contains fields as provided by the Tallyfy API, such as user ID, name, email, status, role, and other metadata.

No binary data is output by this node.

Example output snippet:

[
  {
    "json": {
      "id": "user_123",
      "name": "Jane Doe",
      "email": "jane.doe@example.com",
      "status": "active",
      "role": "standard",
      ...
    }
  },
  ...
]

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.
  • Requires the organization ID to scope 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 errors.
    • Exceeding API rate limits can cause request failures.
    • Providing invalid filter values (e.g., unsupported status) may lead to no results or errors.

  • Error messages:

    • Authentication errors: Check that the API key credential is correctly set up and valid.
    • 404 Not Found: Verify the organization ID and resource parameters.
    • Validation errors: Ensure filter values and limits are within allowed ranges.

  • To resolve issues, verify credentials, input parameters, and consult Tallyfy API documentation for limits and valid values.

Links and References

Discussion