CleverFlow Node for n8n

The CleverFlow integration for n8n allows you to seamlessly connect your workflows with CleverFlow's powerful automation platform. This node enables you to create and retrieve runs directly from your n8n workflows.

Version: 1.0.5

Features

• Create Runs: Generate new workflow runs in CleverFlow with custom field values
• Retrieve Runs: Get run details using either run UID with workspace or numeric run ID
• Dynamic Selections: Automatically fetch available workspaces, workflows, and form fields
• Tally Integration: Process Tally form webhooks and map them directly to CleverFlow runs
• Real-time Updates: Instantly see newly created CleverFlow resources without refreshing
• Naming Support: Give your runs descriptive names for better tracking

What's New in 1.0.5

• Improved File Upload Handling: Better support for file attachments from Tally forms
• Enhanced Checkbox Processing: More robust handling of checkbox groups and nested options
• Better Field Matching: Smarter matching between Tally form fields and CleverFlow fields
• Fixed Run Retrieval: Improved "Get Run" operation using run ID
• Bug Fixes: Various fixes and stability improvements

Configuration

Setting Up Credentials

1. In n8n, go to Credentials and click on "New"
2. Select "CleverFlow API" from the list
3. Enter your API token (without the "Token " prefix)
4. Save your credentials

Using the Node

Create a Run

1. Add the CleverFlow node to your workflow
2. Select "Create" operation
3. Choose the workspace and workflow from the dropdown menus
4. Optionally provide a name for the run
5. Add field values by clicking "Add Field Value" and selecting fields from the dropdown

Get a Run

1. Add the CleverFlow node to your workflow
2. Select "Get" operation
3. Choose how to identify the run:
   • Using "Run UID" (e.g., PL-1) - requires selecting a workspace
   • Using "Run ID" (numeric identifier) - doesn't require workspace

Process Tally Form

1. Add the CleverFlow node to your workflow
2. Select "Process Tally Form" operation
3. Choose the workspace and workflow from the dropdown menus
4. The node will automatically map Tally form fields to CleverFlow workflow fields
5. You can customize the run name using expressions (default uses form name and response ID)
6. Toggle options for handling empty values and invalid fields

Common Use Cases

• Trigger Workflows: Start CleverFlow workflows based on events in n8n
• Form Processing: Automatically process form submissions from Tally into CleverFlow
• Data Synchronization: Push data collected in n8n to CleverFlow workflows
• Status Monitoring: Check the status of existing CleverFlow runs
• Reporting: Retrieve run data to incorporate in reports or dashboards

Example Workflow: Processing Tally Form Submissions

1. Start with a Webhook node to receive Tally form submissions
2. Connect it to the CleverFlow node
3. Configure the CleverFlow node to:
   • Operation: Process Tally Form
   • Select your workspace and workflow
   • Leave default settings for field mapping
4. When the webhook is triggered, the Tally form data will be automatically processed and a new run will be created in CleverFlow

Troubleshooting

• Authentication Errors: Verify your API token is correct and doesn't include "Token " prefix
• Cannot Find Workspace: Make sure your API token has access to the workspace
• Fields Not Appearing: Try selecting the workflow again to refresh field options
• File Upload Issues: Ensure your Tally form is configured correctly for file uploads
• API Connection Issues: Check network connectivity and firewall settings

Support

For questions or issues related to this node, please contact your CleverFlow account manager or support team, or open an issue on the GitHub repository.

License

CLEVERFLOW PROPRIETARY LICENSE

Copyright (c) 2025 CleverFlow

All rights reserved.

This software and associated documentation files (the "Software") are the exclusive property of CleverFlow. The Software is provided for use with CleverFlow services only under the following conditions:

1. No permission is granted to use, copy, modify, merge, publish, distribute, sublicense, or sell the Software without explicit written permission from CleverFlow.

2. The Software may only be used in conjunction with authorized CleverFlow services.

3. This copyright notice and permission notice shall be included in all copies or portions of the Software.

This node is developed and maintained by CleverFlow. CleverFlow is a workflow automation platform designed to simplify complex business processes.