# Box - New CSV file in folder trigger (batch)

The New CSV file in folder (batch) trigger starts a recipe when Box adds a new CSV file to a specified folder. CSV lines run in batches of 100 by default, with a maximum of 50,000.
You can configure encoding, delimiters, header rows, and batch size to match your CSV format.

# Input

Input field Description
When first started, this recipe should pick up events from Select the date and time to begin monitoring. Learn more about this input field.
Folder Select the folder to monitor. You can select from the drop-down menu or enter a folder ID.
Include sub-folders Select Yes to include CSV files in sub-folders.
Sample CSV file Select a sample CSV file for Workato to detect column names. Otherwise, toggle to provide column names manually.
Column delimiter Select the character that separates column values. For example, a comma.
Contains header line Select Yes if the first row of the CSV contains column names.
Batch size Enter the number of rows per batch. By default, Workato processes 100 rows per batch. Maximum is 50,000.
Expected encoding Select the encoding type of the CSV file. Default is UTF-8.
Include copied/moved files Select Yes if the trigger should treat copied or moved files as new files. Default is No.

# Output

Output field Description
Event Type of trigger event.
ID Unique ID of the CSV file.
Name File name.
Type Object type.
Description File description.
Size File size in bytes.
Shared link Shared link details for the file.
Created at Date and time the file was created.
Modified at Date and time the file was last modified.
Trashed at Date and time the file was moved to trash.
Purged at Date and time the file was permanently deleted.
Content created at Date and time the file content was created.
Content modified at Date and time the file content was modified.
Sequence ID Position of the file in the folder hierarchy.
Etag Entity tag of the file.
Sha 1 SHA-1 hash of the file.
Parent Parent folder details of the file.
Path Path of the file.
Path collection Collection of folder paths the file belongs to.
Created by User who created the file.
Modified by User who last modified the file.
Owned by User who owns the file.
Item status Current status of the file. For example, active.
First Indicates if this is the first batch of rows.
Last Indicates if this is the last batch of rows.
Lines Contains the list of CSV rows in the batch. Each row includes its columns and values.


Last updated: 10/3/2025, 8:10:59 PM

On this page