TallyfyInstall

Overview

This node integrates with the Tallyfy workflow automation platform to find the ID of a group by its name or search term. It is useful when you need to programmatically retrieve the unique identifier of a group within your Tallyfy organization, for example, to assign tasks, manage permissions, or reference groups in other operations.

A practical scenario would be automating task assignments where you only know the group name but require the group ID to set ownership or permissions in subsequent workflow steps.

Properties

Output

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

• id: The unique identifier of the group.
• name: The name of the group (or title/label/email fallback).
• type: The type of ID found, here always indicating "Group".

Example output JSON structure:

[
  {
    "id": "group-id-123",
    "name": "Marketing Team",
    "type": "Group"
  },
  {
    "id": "group-id-456",
    "name": "Sales Team",
    "type": "Group"
  }
]

If multiple groups match the search term, all are returned as separate items.

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 group names in your Tallyfy organization.
• Authentication errors: Verify that the API key credential is valid and has access to the organization.
• API rate limits or connectivity issues: Check network connectivity and Tallyfy API status.
• Malformed input: The search term must be a non-empty string; empty or invalid inputs will not return results.

Links and References

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