Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node integrates with the Tallyfy workflow automation platform to manage groups within an organization. Specifically, the Group - Create operation allows users to create a new group by specifying its name, description, and members (both users and guests). This is useful for organizing users into logical units for task assignments, permissions, or communication within Tallyfy.

Common scenarios:

  • Automating the creation of project teams or departments as groups in Tallyfy.
  • Dynamically adding users and guests to newly created groups based on external triggers.
  • Structuring user access and collaboration by grouping related members.

Example:
You might use this node to create a "Marketing Team" group with a description and add specific user IDs and guest emails to it, enabling streamlined task assignments to that team.

Properties

Name Meaning
Group Name The unique name of the group to be created.
Description Optional text describing the purpose or details of the group.
Members Comma-separated list of user IDs to add as members of the group.
Guests Comma-separated list of guest email addresses to add as guests to the group.

Output

The output JSON contains the response from the Tallyfy API after creating the group. It typically includes the group's details such as its ID, name, description, members, guests, and other metadata returned by the API.

If multiple input items are processed, the output will be an array of such JSON objects, one per created group.

The node does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the Tallyfy API.
  • Needs the organization ID configured in the credentials to target the correct Tallyfy organization.
  • Uses the base URL https://go.tallyfy.com/api unless overridden in credentials.

Troubleshooting

  • Error: Duplicate group name
    The group name must be unique within the organization. If you receive an error about duplication, choose a different group name.

  • Invalid user IDs or guest emails
    Ensure that user IDs and guest emails provided in the members and guests fields exist and are valid in your Tallyfy organization.

  • Authentication errors
    Verify that the API key credential is correctly set up and has sufficient permissions to create groups.

  • Malformed input
    Comma-separated lists for members and guests should not contain extra spaces or invalid characters; trim and validate inputs before use.

Links and References

Discussion