Notifications Node Editor — Overview

The Notifications Node Editor lets you visually build boolean logic that runs on scraped Reddit post data to decide whether to trigger a notification.

Workflows always evaluate to a single boolean at the output node: true triggers a notification.

What you can do

  • Compose workflows from nodes (inputs, arithmetic, logic, output)
  • Connect nodes to define data flow
  • Configure parameters for primitive values
  • Execute against Reddit post data and get a trigger result
  • Inspect specific nodes over time with Node Focus

Core concepts

  • Node: An operation block with typed inputs/outputs and parameters
  • Socket: A named input or output on a node
  • Connection: A directed link from an output socket to an input socket
  • WorkflowGraph: A set of nodes and connections that evaluates to a boolean
  • Registry: Catalog of available node types and categories
  • Execution Engine: Runs a workflow via topological ordering with validation and cycle detection

Node categories

  • Input: Post metrics (upvotes, comments, AI sentiment), deltas, rates, accelerations
  • Primitive: Integer, Float, String, Boolean
  • Arithmetic: Add, Subtract, Multiply, Divide
  • Boolean/Logic: Greater/Less/Equal, AND, OR, NOT
  • Output: Trigger Notification (final boolean)

Typical data flow

Post data → input nodes → processing (arithmetic/logic) → output node → boolean result

Keep graphs acyclic. The engine rejects cycles and invalid connections.

Prerequisites

  • Access to the Notifications editor page in the app
  • A Reddit scraping session or test payloads for validation

Build your first workflow

  1. Open the editor and create a new workflow.
  2. From the palette, drag in:
    • Post Upvotes (Input)
    • Integer (Primitive) and set value = 500
    • Greater Than (Boolean)
    • Trigger Notification (Output)
  3. Connect Post Upvotes → A and Integer → B on Greater Than.
  4. Connect Greater Than.Result → Condition on Trigger Notification.
  5. Save and test with a post where upvotes > 500.

Validation and reliability

  • The engine topologically sorts nodes for correct execution order.
  • Structural checks catch cycles, missing outputs, and type mismatches.
  • Execution tracing can be surfaced in tooling for debugging.

Observability with Node Focus

Use Node Focus to record inputs, outputs, and timing for selected nodes over time. See the Node Focus guide for setup, APIs, and best practices.

Next steps

  • Read the Node Focus guide
  • Explore node type capabilities in the Reference
  • Try the minimal sample and the end-to-end codelab