Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform

Overview

This node integrates with the Tallyfy workflow automation platform, specifically enabling users to launch new process instances based on existing blueprints. The "Process - Launch" operation creates a new running process from a specified blueprint and assigns it a custom name.

Typical use cases include automating business workflows by programmatically starting processes defined as blueprints in Tallyfy. For example, launching an onboarding process for a new employee or initiating a purchase approval workflow.

Properties

Name Meaning
Blueprint ID The unique identifier of the blueprint (process template) from which to launch the process.
Process Name The name to assign to the newly launched process instance.

Output

The node outputs JSON data representing the newly created process instance returned by the Tallyfy API. This typically includes details such as the process ID, name, status, creation timestamps, and other metadata about the launched process.

No binary data output is produced by this operation.

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 provided in credentials.
  • Requires the organization ID associated with the authenticated user to construct API endpoints.

Troubleshooting

  • Common issues:

    • Invalid or missing Blueprint ID: Ensure the blueprint ID is correct and exists in your Tallyfy organization.
    • Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
    • Network or connectivity problems: Check internet access and Tallyfy service availability.
  • Error messages:

    • Errors returned from the Tallyfy API will be propagated. If the node is set to continue on fail, error details will appear in the output JSON under an error field.
    • Typical HTTP errors include 401 Unauthorized (invalid credentials), 404 Not Found (invalid blueprint ID), or 400 Bad Request (missing required parameters).

Links and References

Discussion