Setup the Box integration and get all the insights in Torii's dashboard

Overview

Torii integrates with Box and syncs:

• Box users, including their roles and status
• Wasted licenses
• Last usage date and usage frequency
• You can constantly stay updated with application information from our Integrations Page >> Integration Capabilities button >> Integration Capabilities table.
  

Requirements

Accounts & Permissions

• A Box Admin or Co-Admin account is required for the integration.
• For usage frequency data:
  • Co-Admins need the Run new reports and access existing reports permission, which can be set in the Box Admin Console under Reports and settings.
  • Torii needs permission to access the /events endpoint. Steps to resolve

Scopes

Always requested:

• Manage users (manage_managed_users) - to sync your Box managed users.
• App users (manage_app_users) - to sync your Box app users.
• Enterprise properties (manage_enterprise_properties) - to read your Box enterprise properties.

Optional, available with Read & Take action:

• Act on behalf of users (admin_on_behalf_of) - needed for the Transfer user files action.
• Read all content (root_readonly) - to read a user's files and folders when transferring them.
• Manage all content (root_readwrite) - to transfer a user's files and folders to another user (Transfer user files action).
• Manage groups (manage_groups) - to list your Box groups and add or remove users from them (Add/Remove Box user to/from groups actions).

How to Connect the Integration

1. Go to the Integrations page and select the Box tile.
2. Click Connect.
3. Select the permission type: Read, or Read & Take action. Read & Take action is required to use any of the actions below from Torii.
4. With Read & Take action, select the optional permissions for the actions you plan to use. For example, select Manage groups to use the groups actions.
5. Click Connect.
   
6. Approve the required scopes in Box.
7. Once the integration is connected and synced, it displays a green checkmark.
   

Additional Notes

• The Box API does not report usage events from the Box desktop app (Box Sync), so usage data is limited to online events.

Actions

With Read & Take action permission, you can run these Box actions from Torii workflows:

• Create Box user - creates a Box user with their email, first and last name, and an optional role (User or Co-admin; User by default). If a user with that email already exists in the Box account, the action completes and reports that the user already exists.
• Update Box user - updates the user's full name, job title, phone and address. Fields left empty keep their current value in Box.
• Change Box user role - sets the user's role to User or Co-admin.
• Delete Box user
• Reactivate Box user - sets a deactivated user back to active.
• Deactivate Box user
• Add Box user to groups - adds the user to one or more Box groups. If the user is already a member of a group, that group is marked as completed.
• Remove Box user from groups - removes the user from one or more Box groups. If the user isn't a member of a group, that group is marked as completed.
• Transfer user files - moves all files owned by a user into another user's account.

For any further questions, please contact Torii Support.