Box Connector Reference
Box is a general purpose, SaaS enterprise content management system. Organizations use Box to securely manage and to collaborate on documents, images, videos and various other files.
Connections
To connect to a system, whether it is a source of data or the target where you are sending data, you must create a connection with that system’s required credentials. You typically connect to different systems within a flow and can reuse each connection every time you need to connect.
This system requires the following credential information for its connections:
- Connection Name
-
Enter a connection name that will help you remember the details of this connection. You can reuse connections multiple times in a single flow, and in more than one flow, and the credentials are hidden after you create the connection. Therefore, it’s helpful to provide a name that easily identifies this connection from others.
Only you can see the connection. Other users in your Composer app must create their own connections.
- Username
-
The OAuth username that you use to log in to Box.
- Password
-
The OAuth password that you use to log in to Box.
Triggers
Each flow starts with a scheduler that specifies a time span for how frequently the flow starts or with a trigger that you define, such as "each time a new record is created." Triggers provide multiple options related to the data in your system.
Triggers execute every ten minutes.
This system provides the following trigger options:
- On new file in folder
-
Triggers when a new folder is added. Provide a value for Folder ID.
Actions
After you connect to a system and define the trigger or configure a scheduler, you define the actions that the flow performs, such as copying a record from Workday to Salesforce. The actions you can perform depend on which system you are connected to.
This system provides the following actions:
- Add file to folder using URL
-
Adds a file to a folder in Box which is referenced by a publicly-shared URL. Provide a value for the following fields:
-
Folder ID
-
Source URL
-
- Add file to folder using file content
-
Adds a file to a folder in Box. Provide a value for the following fields:
-
File content
-
Folder ID or Source URL
If a file exists in the folder, enter a value in the Folder ID field to overwrite the existing file. To create a new file in the folder, enter a value in the File Name field.
-
- Create folder
-
Creates a folder in the Box structure. Provide a value for the following fields:
-
Parent Folder ID
-
Folder name
-
- Create file metadata
-
Creates file metadata by populating a metadata template on a file in Box. Provide a value for the following fields:
-
File ID
-
Metadata template
Multiple selection field types, such as checkboxes, do not appear in Composer.
-
- Update file metadata
-
Updates file metadata by updating the existing metadata template on a file in Box. Provide a value for the following fields:
-
File ID
-
Metadata template
Multiple selection field types, such as checkboxes, do not appear in Composer.
-