Tallyfy icon

Tallyfy

Interact with Tallyfy workflow automation platform
Join our community

Actions54

Overview

This node integrates with the Tallyfy workflow automation platform, allowing users to manage various resources such as blueprints, processes, tasks, comments, users, guests, groups, and perform searches or ID lookups within Tallyfy. Specifically, for the User resource with the Convert to Guest operation, the node converts a member user into a guest user within the organization.

This operation is useful in scenarios where an organization wants to downgrade a full member's access to guest-level access, typically to restrict permissions or reduce licensing costs. For example, if a user no longer needs full collaboration rights but should still have limited access to certain workflows, converting them to a guest is appropriate.

Properties

Name Meaning
User ID The unique identifier of the user to convert from a member to a guest in the organization.

Output

The output of this operation is the JSON response returned by the Tallyfy API after converting the user to a guest. This typically includes details about the updated user status and any relevant metadata confirming the conversion.

The output structure is:

{
  "json": {
    // User object reflecting the new guest status
  }
}

No binary data 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 to construct API endpoints.
  • The node depends on n8n's HTTP request helper with authentication support.

Troubleshooting

  • Common issues:

    • Invalid or missing User ID: Ensure the User ID provided exists and is correct.
    • Insufficient permissions: The API key used must have rights to modify user roles.
    • Network or API errors: Check connectivity and that the Tallyfy API service is operational.

  • Error messages:

    • "404 Not Found": The specified user does not exist.
    • "401 Unauthorized": Authentication failed; verify API credentials.
    • "403 Forbidden": The API key lacks permission to convert users.

  • Resolution tips:

    • Double-check the User ID input.
    • Verify API credentials and their permissions.
    • Confirm the organization ID is correct.
    • Enable "Continue On Fail" in the node settings to handle errors gracefully during batch operations.

Links and References

Discussion