Box

Connection Type	Alteryx Tool. The latest version is available from the Alteryx Marketplace.
Type of Support	Read and Write

Release Notes

December 8, 2025

Box Version 2.5.7

What's New

Designer displays a clear warning message when users enter an invalid sheet number, sheet name, or sheet range.
The Box connector defaults Time and DateTime precision to milliseconds to avoid extra trailing zeros, while still supporting nanosecond resolution when required by the workflow.

Changes in Behavior

We've disabled the right-click context menu in Designer for the Box tools to prevent unintended actions.

Fixed Issues

Fixed Box Version 2.5.7
ID	Description
TPM-5038	Newly created files in the Box tools inherit the previously selected filename when saved with any extension.
TPM-5006	Selecting Enable Dry Run in the Box Input tool (version 2.5.6) using a DCM connection with JWT authentication causes an error.
TPM-4984	The Box connector version 2.5.7 doesn’t recognize YXDB files.
TPM-4948	An error occurs when uploading a file using the Box tools.
TPM-4853	Special characters in the proxy password cause an error when setting up a manual proxy server for the Box tools.
TPM-4782	Secret values are exposed in the returned JSON in the Designer HTML Developer Tools for the Box tools.
TPM-4754	The Box Input tool returns a "list index out of range" error.
TPM-4645	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-4396	The Box Input tool doesn’t function properly with DCM.
TPM-4239	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for YXDB files that contain only a heading row.
TPM-4192	File name breadcrumbs don’t appear correctly in the Box UI.
TPM-4191	The Box Input tool version 2.5.6 on Python 3.10 adds extra decimal values to datetime fields.
TPM-3832	The SharePoint Input tool version 2.6.2 returns a "Python int too large to convert to C long" error.
TPM-3334	After upgrading to SDK version 2.4.0, null datetime values appear as NaT in CSV files using the Box tools.
TPM-3266	The SharePoint Input (version 2.4.2) and Box Input (version 2.5.2) tools don’t return metadata for CSV and XLSX files that contain only a heading row.

Known Issues

Known Box Version 2.5.7
TPM-2621	The Box connector fails to read files larger than 1.9 GB.

Known

Box Version 2.5.7

Description

TPM-2621

The Box connector fails to read files larger than 1.9 GB.

Cancelled Issues

Cancelled Box Version 2.5.7
ID	Description
TPM-4190	The dry run feature doesn’t work in the Box Input tool version 2.5.6.
TPM-4049	The Box Output tool returns errors when writing large XLSX files.
TPM-3758	The Box Output tool doesn’t retain selected fields as expected.
TPM-3634	File paths don’t update when files are deleted from the Box server using a browser.
TPM-3479	In Box version 2.5.5 (Python 3.8), using the 'Download file locally for later processing' feature with an empty or invalid location doesn’t work as expected in either scenario.
TPM-3477	INT data types upload as FLOAT types when viewed in the Box browser.
TPM-3435	The Box Output tool maps incorrect data types for XLSX files.
TPM-2871	The Box DCM connection returns an invalid access token error after 24 hours.
TPM-2792	The Box Input tools return a "Communication error: Failed to write Control In message" during validation.
TPM-2267	The Box Output tool writes an empty YXDB file if a field is of the DateTime data type.
TPM-2246	The Box Output tool displays an unclear error message for invalid CSV files.
TPM-2133	Field names are not automatically voiced in the Box tools.
TPM-1568	The Box tools experience a significant lag when users click away from the tool.

Version	Description
v2.5.6	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Fixed issue where Box Input couldn’t read data when an Excel column had data of two data types. (TPM-4135) Fixed issue where JSON Web Tokens didn’t work in the Box tools. (TPM-4115, TDCE-520) Fixed issue where the Python SDK didn’t report DCM errors. (TPM-3929) Fixed issue where Box Input didn’t retain the type of date type data. (TDCE-537) Fixed issue where Box Output converted numbers into text. (TDCE-453)
v2.5.5	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Removed usage of .shiv folder. Added support for Alteryx Designer and Server 2024.1. Fixed issue where Box Input ran indefinitely when configured to read an empty dataset. (TPM-2453) Fixed issue where the Box tools couldn’t connect with a newly generated JWT token. (TFLN-1855)
v2.5.4	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Fixed issue where Box Output failed to write fixedDecimal data type into YXDB files. (TPM-2111) Fixed issue where Box Output failed to overwrite certain large Excel files. (TPM-2169)
v2.5.2	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. For Box Input, added an option include subfolders when utilizing wildcard search, downloading files locally, or when user opts to Process file as. Fixed performance issue when utilizing wildcard search in Box Input. (TPM-2027) Fixed issue where wildcard search was returning an error the first time workflow ran. (TPM-1847) Fixed issue where Box Output failed to write various number and date-time data types into YXDB files. (TDCE-96, TPM-1958) Fixed issue where workflow failed when Box Output was configured to use incoming field to dynamically name one or more output files. (TPM-1980) Fixed issue where the Box configuration panel showed intermittent error when left open for a long period of time. (TFLN-1210) Known Issue Box Output fails to write fixedDecimal data type into YXDB files. (TPM-2111) Alteryx Server requires the AllowAll value of the SDK Access Mode settings.
v2.5.1	Compatible with Alteryx Designer and Server 2021.4.2 Patch 6, 2022.1 Patch 4 and later. Requires AMP engine. Fixed issue where the Configure File tab was resent when users pressed Enter in the File Path field. (TFLN-1209) Fixed issue where reading a XLSX file with Null values resulted in error. (TDCE-92) Fixed issue where a workflow run with the Box connectors using JWT authentication failed to run after a day, with the cryptography or Invalid access token error. (TPM-1802) Fixed issue where Box Output failed to append data when it contained quoted delimiter character. (TDCE-28) Fixed issue where Box Output either failed to write date and date-time data types, or changed the date to 70 years in the future. (TPM-1902) Known Issue Box Output fails to write various number and date-time data types into YXDB files (TDCE-96). Workaround is to output data into CSV or XLSX.
v2.5.0	Compatible with Designer 2021.4.2 Patch 4, 2022.1 Patch 2 and later. Requires AMP engine. Added support for DCM. DCM is required for running this connector on Alteryx Server. Added option to overwrite only one sheet added. Changed the behavior of sheet and file name field to be excluded from the written data. Added option to keep the sheet and file name field. SSL/TLS validation is now performed against Windows Certificate Store. FIPS capable. Fixed issue with dynamic naming of files. (TPM-1688) Known Issue Alteryx Server requires the AllowAll value of the SDK Access Mode settings.
v2.4.0	Compatible with Alteryx Designer 2021.4.2 and later. Append and Overwrite options now create a new version of the file rather than deleting the old file and creating a new one. This preserves the file’s version history and shared links. Removed the limit of 100 files downloaded from a single folder.
v2.3.0	Authentication occurs using user's browser instead of embedded CEF in Designer to comply with modern security policies. Minor bugfixes.
v2.2.0	Added an option to pass column information (column names and data types) to connected tool without the need to run the workflow. Added Dynamic Output Added an option to upload local files to Box using Box Output. Write Headers checkbox is now enabled by default. Minor bugfixes.
v2.1.1	Fixed blank screen issue when authenticating in Designer 2021.3.2.54175. Note that you also need to update to Designer 21.3.3.63061 or later. A whitelisting header need to be added in your Box app after you update.
v1.0.0	Supports OAuth (including SSO) and Access Token Authentication Methods Allows users to download the folders and files locally. Requires Alteryx Designer 2021.3 and Later

Alteryx Tools Used to Connect


Box Input Tool	Box Output Tool

Use the Box connector to run, schedule, and publish workflows from Designer, using files stored in your Box workspace. Supported file types are XLSX, CSV and YXDB.

Caution

Desktop Automation (Scheduler) is not supported by this connector.

Data Connection Manager

The Box tools version 2.5.0 and later support Data Connection Manager for an easier and a safer storage of your credentials. Create a connection to Box and easily reuse the stored credentials in workflows that include the Box tools. Alteryx Server requires stored credentials to successfully run the published workflows.

Enable AMP Engine

Make sure you have the AMP engine enabled for the workflows which contain the Box tools version 2.5.0 and later to leverage the full potential of Designer capabilities.

Box App Registration

Log in to https://alteryx.app.box.com/developers/console using your Box credentials.
Select Create New App.
Select Custom App.
In Authentication Method, select User Authentication (OAuth 2.0). Enter App Name and select Create App.
On the Configuration tab in Application Scopes, select Write all file and folders stored in Box to provide permission to the app.
Select Save Changes.
To generate a new developer token, select Revoke and then select Generate Developer Token.
You can use Client ID and Client Secret from OAuth 2.0 Credentials for authentication.

Custom Application Setup

To avoid a Box CORS issue when using the app with OAuth authentication or Access Token and JWT, use a custom configuration:

Box app with OAuth authentication:
1. Add Redirect URI https://cef.alteryx.com/designer/oauthcallback to resolve the CEF window CORS issue.
2. Enter file://* for Allowed Origins.
Box app with Access Token and JWT authentication:
1. Enter file://* for Allowed Origins.

In this section:

Box