Read JSON File

Controlled node

Overview

The Read JSON File node reads a JSON file from the project library and parses its contents into workflow data. It is useful for loading saved configuration, extracted records, API responses, or structured outputs written by another workflow.

Inputs

Input	Type	Description	Default
Run	Event	Triggers the JSON file read and parse.	-
File	FileSource	The JSON file to read from the library. The picker is filtered to application/json files.	-

Outputs

Output	Type	Description
Done	Event	Fires when the node has finished running.
Output	Data	The parsed JSON value. If the file cannot be read or parsed, this output contains an error object.

Runtime Behavior and Defaults

• Controlled Node: The node runs only when the Run event fires.
• Project Requirement: A runtime project ID is required so the node can read from the project library.
• File Selection: If File receives an array, the node reads the first file in the array.
• File Validation: The runtime requires a valid file reference with an id.
• JSON Parsing: The runtime reads the file as raw text, then parses it with JSON.parse.
• Error Handling: If the project ID, file reference, file read, or JSON parsing fails, Output contains an error object instead of parsed data.

Example Usage

Load Structured Data

1. Select a .json file in the node panel, or connect a file reference from Find Library Files or Get Library Files to File.
2. Trigger Run from a Start node or another event.
3. Connect Output to Validate Schema, Map List, or another data-processing node.

The node returns the parsed JSON as workflow data.

tip

Use Write JSON File to save structured workflow output in the format this node expects.