Box
Files & storageOAuth 2.0Connection test available
Box content management — upload, download, organise, search and share files.
OCNORA ships 16 typed Box operations and 1 trigger. Each node has a schema-driven form, input and output tables beside its settings, and is pre-flighted by Workflow Health before your first real run.
Before you connect Box
- Authentication
- OAuth 2.0
- Credential
- the Box app credential, plus webhook_signature_primary_key (and webhook_signature_secondary_key while a key is being rotated){"client_id": "…", "client_secret": "…", "box_subject_type": "enterprise|user", "box_subject_id": "…"} for a server-authentication app, or {"client_id": "…", "client_secret": "…", "refresh_token": "…"} for OAuth2
- Connection test
- Available: the stored credential can be checked against the provider when you add it. This is not a record that a test was run or passed.
- Prerequisites
- Box generates the two webhook signature keys in the Developer Console (the app's Webhooks tab, Manage signature keys) and no API returns them, so the primary key must be stored on this connection as webhook_signature_primary_key. Publishing without it is refused: Box would sign deliveries that could never be verified. Publishing also needs MANTLE_APP_PUBLIC_BASE_URL set to an https URL on port 443 with a CA-signed certificate — Box refuses anything else.
Prerequisites are taken from the connection notes in this provider’s node contracts; each node’s reference page says which apply to it.
What you can do with Box
Operations, grouped by what they do to your data, plus 1 trigger that start a run.
Create and send 5
Read and search 7
Update 1
Delete and cancel 3
A sample Box workflow
- 1Eventtrigger.box_eventStart a run when a Box file or folder is uploaded to, changed or shared.
- 2Download Filebox.download_fileDownload a file's content and emit it as the shared base64 file envelope, ready to hand to a storage or mail node.
- 3Add Collaborationbox.add_collaborationInvite a user or group to collaborate on a file or folder with a given role.
An outline built from this provider’s node contracts, not a recorded run. Each step’s output fields are available to the next in the field picker.
Every node below has a reference page: what it does, the connection it needs, its config fields with types, constraints and examples, and the shapes it emits.
Triggers 1
Operations 16
- Add CollaborationInvite a user or group to collaborate on a file or folder with a given role.box.add_collaboration
- Copy FileCopy a file into another folder, optionally storing the copy under a different name.box.copy_file
- Create FolderCreate a subfolder inside another folder, or at the account root.box.create_folder
- Create Shared LinkAdd or update the shared link on a file or folder and return the URL people can open.box.create_shared_link
- Delete FileMove a file to the Box trash, from where it can still be restored until the trash retention period expires.box.delete_file
- Delete FolderMove a folder to the Box trash. Box refuses a folder that still has contents unless 'recursive' is switched on.box.delete_folder
- Download FileDownload a file's content and emit it as the shared base64 file envelope, ready to hand to a storage or mail node.box.download_file
- Get File InfoRead a file's metadata — name, size, checksum, parent folder and timestamps — without downloading its content.box.get_file_info
- Get FolderRead a folder's metadata — name, parent, description and shared link — without listing its contents.box.get_folder
- Get UserRead a Box user's profile; 'me' returns the account the connection authenticates as, which is also what the connection test calls.box.get_user
- List CollaborationsList who has been given access to a file or folder, and with which role.box.list_collaborations
- List Folder ItemsList one page of the files and folders directly inside a folder.box.list_folder_items
- Move FileMove a file to another folder and/or rename it in place.box.move_file
- Remove Shared LinkRemove the shared link from a file or folder so the existing URL stops working.box.remove_shared_link
- SearchSearch the account's content by keyword, narrowed by item type and by the folder subtrees to look inside.box.search
- Upload FileUpload a new file into a folder, taking its content from 'body' as text or as a base64 blob from an upstream download node.box.upload_file
Box questions
- How does OCNORA authenticate with Box?
- With a stored OAuth 2.0 credential, shaped the Box app credential, plus webhook_signature_primary_key (and webhook_signature_secondary_key while a key is being rotated) or {"client_id": "…", "client_secret": "…", "box_subject_type": "enterprise|user", "box_subject_id": "…"} for a server-authentication app, or {"client_id": "…", "client_secret": "…", "refresh_token": "…"} for OAuth2. A connection test can check it when you add it.
- What can I automate with Box?
- 16 typed operations and 1 trigger, each with a reference page listing its config fields and the shapes it emits.
- What if the Box operation I need is not listed?
- Where Box has an HTTP API, call it from the HTTP node with the same credential, or describe the step to the AI builder, which asks our team for a typed node when one is missing.
- Are there templates that use Box?
- Not yet. Start from a blank workflow, or describe the workflow to Build with AI.
- How are Box calls controlled?
- Every call and every run step is audited, runs count against the execution budget, and Workflow Health pre-flights the workflow when you save it.
See your first Box workflow run.
Book a technical demo. We add the connection, pick a template or describe the workflow to Build with AI, and Workflow Health checks it before it runs.