Event Wait — Input & Output

Output Ports

Port	Condition	Description
success	The expected event was received before the timeout	The event payload is available at `output.NodeName.event_payload`. The workflow continues along this port to process the event data.
timeout	The event did not arrive within `timeout_seconds`	No payload is available. Connect this port to a notification branch, retry path, or workflow failure handler. Does not fire if `timeout_seconds` is 0.
error	Event bus registration failed or invalid configuration	Details in `output.NodeName.error`. Rare — typically caused by an invalid `event_name` (empty string) or an infrastructure issue with the event bus.

Output Data Schema

Field	Port	Type	Description
`event_payload`	success	any	The data published with the event. Structure depends on the publisher. Can be an object, string, number, or array.
`event_name`	success	string	The name of the event that was received. Useful for logging when a node listens for multiple event types (future feature).
`received_at`	success	string (ISO 8601)	The UTC datetime when the event was received and the workflow was resumed.
`timed_out_at`	timeout	string (ISO 8601)	The UTC datetime when the timeout expired.
`waited_seconds`	timeout	integer	The number of seconds the workflow waited before timing out.

Example Output (success port)

// Event published by payment gateway:
// { event_name: "payment.confirmed", correlation_key: "ORDER-1234",
//   payload: { transactionId: "TXN-99887766", amount: 486.00, currency: "USD", method: "card" } }

// Output of WaitForPaymentConfirmation node (success port):
{
  "event_payload": {
    "transactionId": "TXN-99887766",
    "amount": 486.00,
    "currency": "USD",
    "method": "card"
  },
  "event_name": "payment.confirmed",
  "received_at": "2026-05-23T10:34:12Z"
}

// Downstream access:
// {@ output.WaitForPaymentConfirmation.event_payload.transactionId } → "TXN-99887766"
// {@ output.WaitForPaymentConfirmation.event_payload.amount }        → 486.00

Example Output (timeout port)

{
  "timed_out_at": "2026-05-23T11:04:12Z",
  "waited_seconds": 1800,
  "event_name": "payment.confirmed"
}