Combine Events

Controlled node

Overview

The Combine Events node acts as an event aggregator that triggers its output when any of its input events fire. This node implements an "OR" logic for events—whenever one or more input events are received, the done event immediately fires.

By default, the node provides two event inputs (event0 and event1), but you can configure it to accept up to 10 event inputs using the Event Count property. This is useful for triggering the same downstream logic from multiple sources, such as consolidating error handlers or allowing a workflow to be triggered by different user actions.

Inputs

Input	Type	Description	Default
Event Count	Number	Specifies how many event inputs the node should have (minimum 2, maximum 10). Changing this value dynamically adds or removes event input sockets.	2
event0	Event	First event input that can trigger the node.	-
event1	Event	Second event input that can trigger the node.	-
event2...event9	Event	Additional event inputs (visible when Event Count is increased).	-

Outputs

Output	Type	Description
done	Event	Fires immediately when any of the input events (event0, event1, etc.) are triggered.

Runtime Behavior

When the Combine Events node receives any event on one of its input sockets (event0, event1, etc.), it immediately fires the done event. The node does not distinguish between which input event fired—all inputs are treated equally as triggers.

Dynamic Socket Creation

The number of event input sockets is dynamic based on the Event Count setting. When you increase the count in the properties panel, additional sockets (event2, event3, etc.) appear automatically up to a maximum of 10. When you decrease the count, the excess sockets are removed along with any connections.

Example Usage

Scenario: Multiple Trigger Sources

You have a workflow that should execute the same processing logic when triggered by different sources (e.g., a button click, a scheduled timer, or an external webhook).

Setup:

1. Add a Combine Events node to your workflow
2. Set Event Count to 3
3. Connect the button's click event to event0
4. Connect the timer's tick event to event1
5. Connect the webhook's received event to event2
6. Connect the done output to your shared processing logic

Now whenever any of those three events occur, your processing logic will execute.

Scenario: Consolidated Error Handling

You have multiple nodes that might fail, and you want to handle all errors with the same error recovery workflow.

Setup:

1. Connect error outputs from multiple nodes to different event inputs on Combine Events (e.g., event0, event1, event2)
2. Connect the done output to your error handling logic
3. Now any error from any source will trigger the same recovery process

Scenario: Form Event Aggregation

You want to run validation logic when any form field loses focus.

Setup:

1. Connect multiple Form Event nodes (listening to different fields) to separate inputs on Combine Events
2. Connect done to your validation node
3. Validation runs whenever any field triggers its event