TallyfyInstall

Overview

This node interacts with the Tallyfy workflow automation platform to find the ID of a blueprint resource by searching for a given name or search term. It is useful when you need to programmatically retrieve the unique identifier of a blueprint (process template) in Tallyfy based on partial or full names, enabling further automated operations such as launching processes or updating blueprints.

Typical use cases include:

• Automating workflows that require referencing blueprints by their IDs without manually looking them up.
• Integrating Tallyfy with other systems where only the blueprint name is known initially.
• Quickly finding blueprint IDs to chain multiple API calls in an automation.

For example, if you have a blueprint named "Employee Onboarding" and want to launch a process from it, this node can find its ID by searching "Employee Onboarding" and outputting the corresponding blueprint ID.

Properties

Output

The node outputs JSON data containing an array of matching blueprint entries. Each entry includes:

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

The output format is an array of objects, each representing a blueprint matching the search term, allowing downstream nodes to select or use the blueprint ID.

Example output JSON snippet:

[
  {
    "json": {
      "id": "12345",
      "name": "Employee Onboarding",
      "type": "blueprint"
    }
  },
  {
    "json": {
      "id": "67890",
      "name": "New Hire Orientation",
      "type": "blueprint"
    }
  }
]

No binary data is output by this node.

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 returned: Ensure the search term exactly or partially matches existing blueprint names in your Tallyfy organization.
• Authentication errors: Verify that the API key credential is valid and has access to the specified organization.
• API rate limits or connectivity issues: Check network connectivity and Tallyfy API status.
• Unexpected errors: Enable "Continue on Fail" to handle errors gracefully and inspect error messages in the output.

Links and References

• Tallyfy API Documentation (for details on endpoints and authentication)
• Tallyfy Official Website