Box

Availability

Core Standard Plus Pro Enterprise Flex PyAirbyte

Connector type (beta)

Data replication Agent(learn more)

Support Level

Marketplace

Connector Version

0.0.22 (last updated 9 days ago)

Sync Success Rate

Low

Usage Rate

Low

Data workers used

0.2 per sync (Learn more)

Definition ID

3eab5d94-2e12-4bca-ab0c-3af869b2dcd8

The Box Connector enables seamless data extraction from Box, allowing users to list, access, and synchronize files or folders from their Box cloud storage. This connector helps automate workflows by integrating Box data with other tools, ensuring efficient file management and analysis

Authentication

This connector uses Box's Client Credentials Grant (CCG) server authentication. Follow the setup guide:

1. In the Box Developer Console, create a Platform App of type Server Authentication (Client Credentials Grant) and copy its Client ID and Client Secret from the Configuration tab.
2. Authorize the app. On an enterprise account, submit the app for approval and have an admin authorize it in Admin Console > Apps > Custom Apps Manager. Re-authorize the app after every change to its configuration.
3. Pick the subject the connector authenticates as (Subject Type):
   • enterprise — authenticate as the app's Service Account. Works with the default App Access Only level; set User ID or Enterprise ID to your enterprise ID (Admin Console > Account & Billing).
   • user — authenticate as a Managed User or Admin. The app's App Access Level must be App + Enterprise Access and Generate User Access Tokens must be enabled; set User ID or Enterprise ID to the user's ID.

If check fails with 400 Bad Request from https://api.box.com/oauth2/token, Box rejected the grant (invalid_grant - Grant credentials are invalid): the client ID/secret are wrong or belong to different apps, the app is not authorized in the Admin Console, or the chosen Subject Type is not allowed by the app's access level. See Box's common errors.

Configuration

Input	Type	Description	Default Value
client_id	string	OAuth Client ID.
client_secret	string	OAuth Client Secret.
user	number	Box user ID (Subject Type user) or enterprise ID (Subject Type enterprise) to authenticate as.
box_subject_type	string	Subject Type: user or enterprise.	user

Streams

Stream Name	Primary Key	Pagination	Supports Full Sync	Supports Incremental
events		DefaultPaginator	✅	❌
sign_templates	id	DefaultPaginator	✅	❌
collections	id	DefaultPaginator	✅	❌
collection_items	id	DefaultPaginator	✅	❌
sign_request	id	DefaultPaginator	✅	❌
admin_logs	event_id	DefaultPaginator	✅	❌
files	id	DefaultPaginator	✅	❌
file_collaborations	id	DefaultPaginator	✅	❌
file_comments	id	DefaultPaginator	✅	❌
file_tasks	id	No pagination	✅	❌
folders	id	DefaultPaginator	✅	❌
folder_collaborations	id	DefaultPaginator	✅	❌
recent_items	id	DefaultPaginator	✅	❌
trashed_items	id	DefaultPaginator	✅	❌
users	id	DefaultPaginator	✅	❌

IP allow list

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference

Config fields reference

Field

Type

Property name

OAuth Client ID

required

string

client_id

OAuth Client Secret

required

string

client_secret

number

user

string

box_subject_type

Changelog

Expand to review

Version	Date	Pull Request	Subject
0.0.22	2026-10-07	88216	Add optional box_subject_type (user/enterprise) so the CCG token request can authenticate as the app Service Account; document Box app setup
0.0.21	2026-04-21	76536	Update dependencies
0.0.20	2025-05-24	60665	Update dependencies
0.0.19	2025-04-26	58701	Update dependencies
0.0.18	2025-04-19	58259	Update dependencies
0.0.17	2025-04-05	57131	Update dependencies
0.0.16	2025-03-22	56147	Update dependencies
0.0.15	2025-03-08	55361	Update dependencies
0.0.14	2025-03-01	54833	Update dependencies
0.0.13	2025-02-22	54236	Update dependencies
0.0.12	2025-02-15	53877	Update dependencies
0.0.11	2025-02-08	53399	Update dependencies
0.0.10	2025-02-01	52888	Update dependencies
0.0.9	2025-01-25	52167	Update dependencies
0.0.8	2025-01-18	51757	Update dependencies
0.0.7	2025-01-11	51291	Update dependencies
0.0.6	2024-12-28	50497	Update dependencies
0.0.5	2024-12-21	50209	Update dependencies
0.0.4	2024-12-14	49580	Update dependencies
0.0.3	2024-12-12	49276	Update dependencies
0.0.2	2024-12-11	48933	Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.0.1	2024-10-24		Initial release by @bishalbera via Connector Builder