Box

The Box modules allow you to monitor a specified folder for file changes, modify and delete existing files, and upload new files to a folder from your Box account.

To get started with Box, create an account at box.com.

Connect the Box to {{Make}}
  1. Log in to your Box account, and add a module from the Box app into an {{Make}} scenario.

    box-2.png
  2. Click Add next to the Connection field.

  3. Optional: In the Connection name field, enter a name for the connection and click Save.

  4. Optional: Click Show Advanced Settings and enter client credentials from your custom app. See Box Custom App Documentation.

  5. Click Save.

  6. Confirm the access by clicking Grant access to Box.

The connection has been established.

Files
New File Event

Triggers when selected actions occur on a file.

[Note] Note

{{Make}} automatically creates a webhook in Box once you add an instant trigger to your scenario.

Watch Files

Triggers when a new file is added or an existing file is updated in a folder being watched.

Get a File

Retrieves information about a file.

Download a File

Downloads a file.

Upload a File

Uploads a new file.

Add a Shared Link to a File

Adds a shared link to a file.

Update a File

Updates file attributes.

Rename a File

Renames a file.

Delete a File

Deletes a file or moves it to trash.

Create File Metadata Instance

Applies an instance of a metadata template to a file.

Get File Metadata

Retrieves file metadata by its ID.

Update File Metadata

Creates or updates metadata of a file.

Folders
New Folder Event

Triggers when selected actions occur on a folder.

[Note] Note

{{Make}} automatically creates a webhook in Box once you add an instant trigger to your scenario.

Create a Folder

Creates a new empty folder within the specified parent folder.

Add a Shared Link to a Folder

Adds a new shared link to a folder.

Get a Folder

Retrieves information about a folder, including the first 100 entries in that folder.

Update a Folder

Updates folder attributes.

Rename a Folder

Renames a folder.

Delete a Folder

Deletes a folder, either permanently or by moving it to trash.

Create Folder Metadata Instance

Applies an instance of a metadata template to a folder.

Get Folder Metadata

Retrieves folder metadata by its ID.

Update Folder Metadata

Updates folder's metadata.

Get Folder Items

Retrieves files, folders, and web links in a folder.

Other
Make an API Call

Performs an arbitrary authorized API call.

[Note] Note

For the list of available endpoints, refer to the Box API Documentation.

Search for Content

Searches for items that are available to the user or an entire enterprise.

Get a File/Folder by Shared Link

Retrieves information about a file/folder by a shared link.

Create a Comment

Creates a new comment to a file.

Copy a Folder

Copies the selected folder.

Troubleshooting
Watch files trigger did not download a file contained in the folder.

There are several situations when downloading a file fails:

  • The current file lock settings do not allow the file to be downloaded or the downloading of the file is disabled. In this case, the file is ignored.

  • When the scenario started, the file was being uploaded to the server and was not ready to be downloaded. The scenario run gets stopped and {{Make}} will try downloading the file again during the next execution of the scenario.

Unable to upload or update a file

There are several situations when uploading or updating a file fails:

  • The uploaded file is too big and exceeds the maximum file size limit for your Box plan, or you have used all of your Box account's storage quota. To get more storage space, delete existing files from Box or upgrade your Box account.

  • Box does not allow you to upload any two files with the same name to one single folder. If the destination folder contains a file with the same name as the file being uploaded, the scenario run terminates with an error. The solution is simply to rename the file. If you aim to update the file, use the Update a file module.

Tips

Automatically rename two uploaded files with the same name in BoxTo automatically rename each file with a unique name you will need to adjust the scenario as shown below.

The overall way that the scenario is supposed to look is as:

61f268075bc1b.png
  • You will need to connect the Ignore error handler: This means if a file exists with the same name in Box then instead of the scenario failing and stopping, the error will be ignored.

61f2680844fa3.png
  • Once you have added the ignore error handler the next step is to add the increment module which is used to uniquely identify files that have the same name. Drag and place the increment module between the Box Upload a File module and the Ignore error handler module.

61f2680945600.png

Once done, configure the module.

  • The next step is to clone and the Upload a file module will save you from remapping it again and then add the Upload a file module in between the Tools-Increment function module and the Ignore error handler again.

61f2680a51a99.png
  • One way of configuring this module, as shown above. Include the file name with the extension. For example, invoice.xml.