Dynamic NodeInstall

Overview

This node allows you to dynamically execute any other n8n node by pasting its exported JSON configuration directly into the node. It effectively runs a sub-workflow containing the specified node, enabling flexible and on-the-fly execution of arbitrary node logic within your workflow.

Common scenarios include:

• Testing or running a single node's logic without creating a separate workflow.
• Dynamically injecting node behavior based on user input or external data.
• Reusing node configurations without duplicating them in multiple workflows.

For example, you could paste the JSON of an HTTP Request node to dynamically perform API calls, or a Function node to run custom JavaScript code, all within this single dynamic node.

Properties

Output

The output is the result of executing the dynamically injected node as a sub-workflow. The json output field contains an array of items produced by that node’s execution.

• If the sub-workflow returns multiple items, they are passed through as an array.
• If no data or unexpected results are returned, the output will be an empty array.
• Binary data handling depends on the executed node; if the embedded node outputs binary data, it will be included accordingly.

Dependencies

• No external services are required beyond what the dynamically executed node itself needs.
• Requires the ability to execute sub-workflows internally within n8n.
• No special environment variables or credentials are needed for this node itself, but the embedded node may require appropriate credentials configured in your n8n instance.

Troubleshooting

• Error: "Dynamic Node must be called with exactly 1 item."
  This node expects exactly one input item. Make sure the previous node outputs only one item.

• Error: "Node JSON must be a valid JSON object or a parseable JSON string."
  The pasted JSON is invalid or malformed. Verify that the JSON is correctly formatted and represents a single node.

• Error: "Node JSON must be an object."
  The provided JSON is not an object (e.g., it might be an array or null). Ensure you paste a single node object.

• Error: "Your JSON must include a name field."
  The node JSON must have a name property. Exported nodes from n8n always include this, so check your JSON.

• Unexpected empty output or warnings about sub-workflow execution result:
  The embedded node might not produce output or the structure returned is unexpected. Check the embedded node’s logic and ensure it produces output items.

Links and References

• n8n Documentation - Creating Custom Nodes
• n8n Workflow Execution
• UUID Library Used for Unique IDs