Overview
Box is an enterprise-focused cloud-file-storage platform. The Automize Box connector covers file/folder operations, users, collaborations, and sharing.
- Regions: Box is a single global service – api.box.com. Enterprise Plus customers can pin data residency to a region via Box Zones (not relevant to API behaviour).
- Plans: Starter, Business, Business Plus, Enterprise, Enterprise Plus – all expose the API. Some features (Box Shield, Box Sign) need higher plans.
Setting up the connection
Auth type: OAuth 2.0 (Authorization Code).
- Go to app.box.com/developers/console → Create New App → Custom App → Standard OAuth 2.0.
- Under Configuration, set Redirect URI to the one in the Automize Box connector dialog.
- Set Application Scopes (read all files, write all files, manage users for org-wide automation).
- Submit for admin approval if your org enforces it (Enterprise feature).
- Copy Client ID + Client Secret.
- In Automize, open Settings → Connectors → Box → Add connection. Paste credentials, click Connect with Box.
Find your credentials at https://app.box.com/developers/console.
Rate limits
Box enforces 10 requests/sec per user (default) – higher on Enterprise via support ticket. The connector retries 429 with Retry-After.
Data model
Box uses numeric IDs:
Enterprise ─┬─ Users
└─ Folders (root folder_id = 0) ─┬─ Sub-folders
└─ Files
Collaborations: users invited to folders/files
folder_id = 0 is the root of any user's drive. file_ids and folder_ids
are numeric strings.Available operations
9 operations available. Click any row to jump to its detail.
| Operation | Category | What it does |
|---|---|---|
| Copy File | General | Copy a file |
| Create Folder | General | Create a new folder |
| Delete File | General | Delete a file |
| Get File | General | Get file details |
| Get Folder | General | Get folder details |
| Get Current User | General | Get current user info |
| List Collaborations | General | List collaborations on a folder |
| List Folder | General | List items in a folder (0=root) |
| Search | General | Search for content |
Operations
Copy File
Copy a file
| Parameter | Required | Type | Description |
|---|---|---|---|
File Id file_id | Yes | text | |
Parent parent | Yes | text | |
Name name | Yes | text |
Create Folder
Create a new folder
| Parameter | Required | Type | Description |
|---|---|---|---|
Name name | Yes | text | |
Parent parent | Yes | text |
Tips
- parent.id (folder_id) + name.
Delete File
Delete a file
| Parameter | Required | Type | Description |
|---|---|---|---|
File Id file_id | Yes | text |
Tips
- Soft-delete to Trash. Restorable for 30 days.
Get File
Get file details
| Parameter | Required | Type | Description |
|---|---|---|---|
File Id file_id | Yes | text |
Tips
- Returns file metadata only. Use Download File for bytes.
Get Folder
Get folder details
| Parameter | Required | Type | Description |
|---|---|---|---|
Folder Id folder_id | Yes | text |
Tips
- Returns folder metadata + path collection (breadcrumbs).
Get Current User
Get current user info
No input parameters.
List Collaborations
List collaborations on a folder
| Parameter | Required | Type | Description |
|---|---|---|---|
Folder Id folder_id | Yes | text |
List Folder
List items in a folder (0=root)
| Parameter | Required | Type | Description |
|---|---|---|---|
Folder Id folder_id | Yes | text |
Search
Search for content
No input parameters.
Tips
- query: substring against name + content. type=file or folder to scope.
FAQ
- Why does Upload fail with 'item_name_in_use'?
- A file with the same name already exists in the target folder. Either delete first or rename – Box doesn't auto-rename.
- Service account vs user OAuth?
- For enterprise-scale automation, prefer JWT-based service account (App User auth). Current connector uses standard OAuth which acts as the connected user. For service account, follow Box's JWT setup separately.
- Box Sign – covered?
- No. Box Sign is a separate Box product with its own API. Use the dedicated Box Sign integration if needed.