# 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