TallyfyInstall

Overview

The "Find Task ID" operation within the "ID Finder" resource of this Tallyfy node allows users to search for task IDs by providing a name or search term. This is useful when you need to programmatically retrieve the unique identifier of a task in Tallyfy based on partial or full task names, enabling further automation such as updating, completing, or commenting on tasks without manually looking up IDs.

Common scenarios include:

• Automating workflows where tasks are dynamically referenced by name.
• Integrating Tallyfy with other systems that require task IDs.
• Quickly locating task IDs for use in subsequent API calls or workflow steps.

Example: You want to find the ID of a task named "Review Budget" to update its properties or mark it complete in an automated process.

Properties

Output

The output is an array of JSON objects representing matching tasks found by the search term. Each object contains:

• id: The unique identifier of the task.
• name: The name/title of the task.
• type: The type of resource found, here it will be "task".

Example output item:

{
  "id": "12345",
  "name": "Review Budget",
  "type": "findTaskId"
}

If multiple matches are found, all are returned as separate items in the output array.

Dependencies

• Requires an API key credential for authenticating with the Tallyfy API.
• Needs the organization ID configured in the credentials.
• Uses the Tallyfy REST API endpoint (default: https://go.tallyfy.com/api).

Troubleshooting

• No results found: Ensure the search term exactly or partially matches existing task names. Check spelling and case sensitivity.
• Authentication errors: Verify that the API key credential is valid and has access to the specified organization.
• API rate limits: If many requests are made rapidly, the API may throttle; implement retries or delays.
• Unexpected response structure: Confirm that the Tallyfy API version matches the node's expectations.

Links and References

• Tallyfy API Documentation
• Tallyfy Official Website