Skip to main content

Box

With Box modules in Celonis Platform, you can manage the files, folders, sign requests, content, and comments in your Box account.

To use the Box modules, you must have a Box account. You can create an account at box.com.

Refer to the Box API documentation for a list of available endpoints.

To establish the connection:

  1. Log in to your Celonis platform account, add a Box module to your Action Flow, and click Create a connection.

  2. (optional) In the Connection name field, enter a name for the connection.

  3. Optional: Click Show Advanced Settings and enter your custom app client credentials. For more information, see the Box Custom App documentation.

    If requested, use the following Redirect URI when creating your custom app: https://auth.redirect.celonis.cloud/oauth/cb/box2.

  4. Click Save.

  5. If prompted, authenticate your account and confirm access.

You have successfully established the connection. You can now edit your Action Flow and add more Box modules.

After connecting the app, you can perform the following actions:

File
  • New File Event

  • Watch Files

  • Get a File

  • Download a File

  • Upload a File

  • Add a Shared Link to a File

  • Update a File

  • Rename a File

  • Delete a File

  • Create File Metadata Instance

  • Get File Metadata

  • Update File Metadata

Folders
  • New Folder Event

  • Create a Folder

  • Add a Shared Link to a Folder

  • Get a Folder

  • Update a Folder

  • Rename a Folder

  • Delete a Folder

  • Create Folder Metadata Instance

  • Get Folder Metadata

  • Update Folder Metadata

  • Get Folder Items

Sign Requests
  • Get a Sign Request

  • List Sign Requests

  • Create a Sign Request

  • Cancel a Sign Request

Other
  • Make an API Call

  • Search for Content

  • Get a File/Folder by Shared Link

  • Create a Comment

  • Copy a 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 Action Flow started, the file was being uploaded to the server and was not ready to be downloaded. The Action Flow run gets stopped and Celonis platform will try downloading the file again during the next execution of the Action Flow.

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 Action Flow 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.

Related topics