Box is a cloud content management and file sharing service. The Box platform enables easy team collaboration.
Box documentation: API guide, Authentication
Important: You can't import a file to Box with this connector if a file with the same name already exists in the destination Box directory.
A. Set up a Box connection
Start establishing a connection to Box in either of the following ways:
- From the Resources menu, select Connections. Then, click + Create connection at the top right.
– or – - While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.
In the resulting Application list, click Box.
The Create connection pane then asks you to name the new connection.
Be sure to provide a clear and distinguishable Name as soon as the connection is created. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.
B. Configure your client ID and secret
At this point, you’re presented with the required settings for Box authentication.
Redirect URL (required/uneditable): Use this URL when configuring your Box app. Use the following steps to add the redirect URL to your Box app.
- Sign in to Box.
- Navigate to the Developer console.
- Click the app you created.
- Click the Configuration tab.
- In the OAuth 2.0 Redirect URI section, click Add a URI.
- Paste the Redirect URL from integrator.io.
- Click Save changes in the upper right corner of the page.
iClient (required): Select the iClient pair that stores the client ID and client secret provided to you by Box. To add an iClient and configure your credentials, click the plus (+) button. Click the edit () button to modify a selected iClient. Be sure to give the iClient a recognizable name for use in any other connections. Use the following steps to find your client ID and client secret.
- Sign in to Box.
- Navigate to the Developer console.
- Click the app you created.
- Click the Configuration tab.
- Copy your client ID and client secret from the OAuth 2.0 Credentials section.
- Paste these values in their respective iClient fields in integrator.io.
Configure scopes (required): Set the required Box scopes for your connection.
C. Edit advanced Box settings
Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Box connection.
Borrow concurrency from (optional): Select another connection from the list....
Concurrency level (optional): Up to 25 allowed....
D. Save and authorize
Once you have configured the Box connection, you have a few options for continuing:
- Test connection – click this button to verify that your new connection is free of errors
- Save – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account
- Cancel – click to exit without saving any new changes
When you select Test connection, the connection is verified before continuing and the status is displayed in the Connection pane.
The new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.