Import Box files

Name your transfer

Name your resource so that you can easily reference it from other parts of the application.

Description

Describe your resource so that other users can quickly understand what it is doing without having to read through all the fields and settings. Be sure to highlight any nuances that a user should be aware of before using your resource in their flows. Also, keep this field up to date as you make changes to the resource.

Connection

Find an existing connection to apply to this export or lookup, or you can click Create connection to define a new resource that you can use here and in other flow steps. Each connection contains securely stored credentials and information needed to access this application. All connections displayed in this list are specific to this application and registered to you for this integration.

One to many

There are advanced use cases where a parent record is being passed around in a flow, but you actually need to process child records contained within the parent record context. For example, if you're exporting Sales Order records out of NetSuite and importing them into Salesforce as Opportunity and Opportunity Line Item records, then you will need to import the Opportunity Line Item records using this option. One to many is used in cases where you have a single record which internally needs to create multiple records. This field cannot be used when importing a CSV file.

Generate files from records

File type

Select the type of file that you want to generate. For example, select CSV if you are importing a flat, delimited text file, or XLSX for a binary Microsoft Excel file. The file name you specify can include a file extension, although it does not affect this file type setting. You'll then be able to select a sample file to define the record structure. See Import files to an FTP server for more information.

How many files would you like to generate?

One file per flow run or one file per page of records.

Directory

Choose how to specify the target folder. The Directory field supports two input modes — Relative path and Folder ID — each with a Browse button that opens a visual folder picker loaded from your Box connection. Click Browse to select a folder instead of typing the path. The selected folder's path or ID is written back to the field automatically. Use the search bar to find folders by name within the folder currently being viewed — search is scoped to the current folder, not your entire account. Folders load in batches; if your target folder is not visible, scroll or use search to locate it. Folder creation is not available in the browser — create folders in Box before browsing.

Relative path

Box paths are case sensitive. The fixed All Files/ prefix is added automatically — type only the path after it (e.g., Reports/Q1). Newly created folders may take up to 10 minutes to appear due to Box search indexing.

Folder ID

Paste the numeric ID from the folder URL (e.g., app.box.com/folder/123456789 → ID is 123456789). The root folder ID is 0. Folder ID bypasses search indexing and is the most reliable way to target a specific folder.

Folder ID mode lets you paste a provider-native folder identifier directly into the field, so Celigo targets the folder without searching by path. Folder IDs are stable across folder renames and accept Handlebars expressions for dynamic targeting.

File name

Use this field to specify how the files being uploaded to Box should be named. You can type '{{{' to include a predefined timestamp template in your file name. For example, 'FileXYZ-{{{timestamp "YY-MM-DD" "America/Los_Angeles"}}}.txt' will upload files with the following pattern: 'FileXYZ-16-06-30.txt' in America/Los_Angeles time. You can include any file extension — it does not affect the type of data generated.

Encrypt files

Use this cryptographic system to encrypt generated files. This option is enabled only when you have configured at least one cryptographic system in the connection. If it is unchecked, then encryption will not be performed on generated files.

File encoding

The file encoding indicates how the individual characters in your data are represented on the file system. Leave this field blank if you do not know what the encoding format is. The default encoding is UTF-8. Other supported formats are Windows-1252 and UTF-16LE.

Compress files

If you would like to compress files before they are posted to the import application, set this field to True. Once you check this field, a dropdown field appears for you to choose the compression format.

Backup directory

Where to store backup copies of processed files using a relative path. Resolved at runtime via the provider's listing API. Leave empty to skip backups.

Relative path

Box paths are case sensitive. The fixed All Files/ prefix is added automatically — type only the path after it (e.g., "Reports/Q1"). Newly created folders may take up to 10 minutes to appear due to Box search indexing. Click Browse to open a visual folder picker and select a folder. The selected folder's path is written back to the field.

Folder ID

Paste the numeric ID from the folder URL (e.g., app.box.com/folder/123456789 → ID is 123456789). The root folder ID is 0. Folder ID bypasses search indexing and is the most reliable way to target a specific folder.

Folder ID mode lets you paste a provider-native folder identifier directly into the field, so Celigo targets the folder without searching by path. Folder IDs are stable across folder renames and accept Handlebars expressions for dynamic targeting. Click Browse to open a visual folder picker and select a folder. The selected folder's ID is written back to the field automatically.