CSV Writer
Write JSON data from upstream nodes to a CSV file and save it to storage.
The CSV Writer node takes JSON data produced by an upstream node, converts it to a CSV file, and saves it to your flow's storage. Each JSON object becomes one row; keys become column headers.
It also handles the common case where AI inference nodes return structured data as a JSON string inside a field — set Parse JSON Field and the node unwraps it automatically before writing.
Configuration
| Field | Description |
|---|---|
| Parse JSON Field | If your upstream node wraps structured data as a JSON string inside a single field, enter that field name here. For Use AI Model outputs, use generated_text. Leave blank if the input is already a JSON array. |
| Filename | Output filename without the .csv extension (e.g. leads). Defaults to flow_output_<timestamp> if left blank. |
| Column Mapping | Optional list of {field → column header} pairs to rename or reorder columns. If empty, all JSON keys are written as-is in the order they appear. |
Inputs & Outputs
| Name | Description | |
|---|---|---|
| Input | json_data | A JSON array from an upstream node — each object becomes one CSV row |
| Output | csv_file | Saved file info: {"filename": "leads.csv", "row_count": 42} |
Appending to an existing file
If a file with the same name already exists in your flow's storage, the CSV Writer appends new rows to it rather than overwriting. New columns in the incoming data are added automatically — existing rows get an empty value for any column they didn't have.
This means you can run the same flow repeatedly and build up a growing dataset in a single file.
Tips
- When used after a Use AI Model node that outputs JSON, set Parse JSON Field to
generated_text— the AI node wraps its output in that field - Use Column Mapping to give your CSV clean, readable headers instead of raw JSON key names
- Leave Filename consistent across runs if you want all results collected in one file
- Connect a Flow Completion Event after this node to get notified when the export is done or if it fails