Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node integrates with the Tallyfy workflow automation platform to find user IDs based on a search term such as a name or email. It is part of a broader set of operations that allow interaction with various Tallyfy resources, but specifically for the "ID Finder" resource and the "Find User ID" operation, it helps users locate the unique identifier of a user within an organization.

Common scenarios where this node is beneficial include:

  • Automating workflows that require referencing users by their IDs rather than names or emails.
  • Integrating Tallyfy user data into other systems where user IDs are needed.
  • Quickly resolving user references in complex workflows without manual lookup.

For example, if you have a user's email or partial name and want to retrieve their Tallyfy user ID to assign tasks or update roles programmatically, this node can perform that lookup efficiently.

Properties

Name Meaning
Search Term The name, email, or any search term used to find the user ID within the Tallyfy system.

Output

The output is a JSON array of objects representing matched users. Each object contains:

  • id: The unique identifier of the user found.
  • name: The name or label associated with the user (could be full name or email).
  • type: The type of ID found, here it will be "User" indicating a user ID.

If multiple users match the search term, the output will contain multiple entries. If no matches are found, the output will be empty.

The node does not output binary data.

Example output JSON snippet:

[
  {
    "json": {
      "id": "12345",
      "name": "Jane Doe",
      "type": "User"
    }
  },
  {
    "json": {
      "id": "67890",
      "name": "John Smith",
      "type": "User"
    }
  }
]

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • Needs the organization ID configured in the credentials to scope the search.
  • Uses the Tallyfy REST API endpoint (default: https://go.tallyfy.com/api).
  • The node relies on n8n's HTTP request helper with authentication support.

Troubleshooting

  • No results returned:
    Ensure the search term is correct and matches existing users in the organization. Also verify that the API credentials and organization ID are valid.

  • Authentication errors:
    Check that the API key credential is properly configured and has sufficient permissions to access user data.

  • API rate limits or timeouts:
    Large organizations or broad search terms might cause delays or rate limiting. Narrow the search term or handle retries accordingly.

  • Unexpected errors:
    The node returns error messages in the output JSON if Continue On Fail is enabled. Review these messages for clues, such as invalid parameters or network issues.

Links and References

Discussion