Skip to main content
sndbox currently implements 54 built-in nodes across triggers, logic, data, network, browser, communication, and system automation. These pages are generated from src/catalogue.ts; names, type IDs, defaults, typed ports, side-effect flags, and supported placements are not hand-copied.
Start with a trigger, connect compatible ports, and map outputs into later node fields. The node inspector only shows settings implemented by that node.

​
How nodes fit together

A workflow combines two separate kinds of connection: Drawing an edge does not automatically map every output. Open the destination node and use its mapping control to select the exact source and path. A source must be upstream on the active control path, and its port type must be compatible with the destination.

​
A reliable starting pattern

  1. Add exactly one trigger and test it with the smallest useful event.
  2. Add read-only nodes first, such as HTTP Request, Read File, or Extract Data.
  3. Test and inspect their real output shapes before creating mappings.
  4. Add Condition or validation steps before nodes that write, send, delete, or execute.
  5. Review permissions, run the complete workflow, and inspect execution evidence.
  6. Only then replace Manual Trigger with Schedule Trigger or another automatic trigger.

​
Choose a category

​
Read a node page

Every reference page includes:
  • concrete use cases and an end-to-end example;
  • the exact implemented defaults and supported option values;
  • typed input and output ports;
  • runtime placement and side-effect status;
  • behavior, failure guidance, and links to deeper concept guides.
The Default node configuration block is the exact generated storage shape. Example settings blocks focus on the fields relevant to the scenario and can contain illustrative IDs or shortened recorded locators.
A node without the catalogue’s generic side-effect flag is not automatically read-only. An HTTP mutation or browser click can still change an external system. Review the configured method, target, account, and downstream effect.

​
Triggers

Manual Trigger

Run from the toolbar.

Schedule Trigger

Run on a local schedule.

File Watch Trigger

Watch an approved folder.

New Email

Poll Gmail safely for matching messages.

​
Logic

Condition

Follow a true or false branch.

Filter

Keep or remove collection items using strict rules.

Switch

Route items through stable named cases.

Loop Over Items

Process a bounded collection in deterministic batches.

Merge

Join named branches without arrival-time races.

Delay

Wait without blocking the runner.

Compare With Previous

Detect a meaningful change and update state after success.

Manual Approval

Pause for local review.

​
Data

Split Out

Expand an explicit array field into workflow items.

Aggregate

Reduce collection items into one deterministic result.

Remove Duplicates

Remove deterministic duplicates within or across runs.

Set Data

Construct a structured object.

Read File

Read text from an approved file.

List Folder

List files in an approved folder.

Parse CSV

Parse CSV text or an approved file.

Parse JSON

Parse JSON text or an approved file.

Parse Text

Split text into lines and basic statistics.

Get Workflow State

Read a value stored by this workflow.

Set Workflow State

Store a value after a successful run.

AI

Send an instruction mid-workflow and wait for the model response.

JavaScript Code

Transform workflow items in a restricted JavaScript runtime.

Python Code

Transform workflow items in a restricted Python runtime.

Code / Source (legacy)

Author a source block or migrate it to a dedicated Code node.

​
Network

HTTP Request

Call an HTTP endpoint.

​
Browser

Open Browser

Start a managed Chromium session.

Navigate

Load a URL in the active session.

Click Element

Click a recorded element.

Fill Field

Enter static or protected data.

Select Option

Choose an option by value, label or index.

Press Key

Send a validated key combination.

Wait For

Wait for page state or an element.

Extract Data

Extract structured values from the page.

Screenshot

Capture viewport, page or element.

Download File

Save a browser download safely.

Upload File

Upload an approved local file.

Close Browser

Close the active managed session.

​
Communication

Get Email

Retrieve a Gmail message.

Create Gmail Draft

Create an editable draft without sending.

Send Email

Send only after explicit workflow approval.

Add Gmail Label

Add or remove message labels.

Discord Webhook

Send a webhook message.

Discord Embed

Send a structured webhook embed.

Slack Webhook

Send an incoming webhook message.

​
System

Desktop Notification

Show a native notification.

Move File

Move within approved folders.

Write File

Write text to an approved file.

Copy File or Folder

Copy within approved folders.

Delete File or Folder

Delete an explicitly approved path.

Run Command

Execute an explicitly approved process.

Web Builder

Combine HTML, JavaScript, and CSS into a localhost site.