Skip to main content
Box

Learn to integrate and use Box steps in Torq for content management, session creation, user tasks, and setting permissions.

Updated over 6 months ago

Box is a cloud-based content management system that includes collaboration, security, analytics, and other features related to information and file storage.

There are two session types, each allowing you to do certain tasks.

User - tasks specific to an individual user

Enterprise - tasks for the entire company

Create a Box steps integration in Torq

  1. Go to Build > Integrations > Steps > Box and click Add.

  2. Enter a meaningful name for the integration and click Add.

  3. In your Box Developer account, enter the application you want to connect to and go to Configuration.

  4. Copy the Client ID under the OAuth 2.0 Credentials and paste that into the Client ID form in Torq.

  5. Click Fetch Client Secret and copy that into the form in Torq. To retrieve the Client Secret, your Box enterprise must enable two-factor authentication.

Use Box steps in Torq

Screenshot of fetching the client secret from Box.

All Box steps require passing an access token as an input parameter. To generate an access token, you must execute the step Create a session.

Create a Session

Select enterprise session for steps requiring the enterprise account and user session for steps running in an individual user's account. You will need the enterprise or user ID, which can be found in Box's General Settings.

Screenshot of the general settings section in Box.

After creating a session, you can proceed with any of the Box steps Torq has included or create an HTTP step of your own.

Search Content

  1. Use the Access Token created in {{ $.create_session.api_object.access_token }}

  2. Search for the information you would like to find, using quotation marks for exact matches (e.g: “John Doe” and not “john doe”)

    1. You may search for multiple items simultaneously using the AND, OR, and NOT operators. For example, John Doe AND “Mississippi” OR torq will get you all the files that include mentions of both John Doe (or john doe) and “Mississippi”, or that include Torq or torq.

    2. You can also limit more of the search, including a limit of items, types of files, and more, by opening the Manage Parameters icon.

Screenshot of configuring the search content step for Box.

Premade Steps

  • Create a folder

  • Create a session

  • Delete a file

  • Delete a folder

  • Get file information

  • Get folder information

  • Get users in the enterprise

  • List items in a folder

  • Lock a file

  • Search content

  • Set file permissions

  • Set folder permissions

  • Unlock a file

  • Update a file

  • Update a folder

Did this answer your question?