> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-docs-confluence-api-token-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

> Follow these steps to connect Box via the StackOne Hub successfully.

<Warning>
  Ensure that your Box account has Admin privileges and has **2-Step Verification** enabled in your [Box Account Settings](https://app.box.com/account/developer).
</Warning>

If you've been directed to StackOne to integrate with Box, the following steps will help you understand the process and any necessary actions to configure a successful integration.

## Log in to Box

<Steps>
  <Step title="Log in">
    Log in to your [Box account](https://account.box.com/login).

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Log in" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image1.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=9cd2b10123f3aab301259f362db942c0" width="1121" height="677" data-path="images/box/image1.png" />
    </Frame>
  </Step>

  <Step title="Go to the Dev Console ">
    Click the **Dev Console** button in the bottom-left navigation to go to your [Box Dev Console](https://app.box.com/developers/console).

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Log in" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image2.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=09d8a08dbae958d9deddeb105615b082" width="481" height="821" data-path="images/box/image2.png" />
    </Frame>
  </Step>
</Steps>

## Create a New OAuth Application

This connection will authenticate on behalf of a registered Application in Box.

<Steps>
  <Step title="Create New Platform App">
    In the *My Platform Apps* page of the Dev Console, click the **Create Platform App** button in the top right.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Create New App" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image3.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=c5e4653ceec7936c3a6128f09885a60b" width="1562" height="364" data-path="images/box/image3.png" />
    </Frame>
  </Step>

  <Step title="Select App Type">
    Under *Create Platform App*, select the **Custom App** option.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select App Type" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image4.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=3c6d5621b6c44855aec6f4e9b7bbd2ca" width="546" height="766" data-path="images/box/image4.png" />
    </Frame>
  </Step>

  <Step title="Enter App Details">
    Under *Create a Custom App: Step 1 of 2*, enter an App Name.

    Select **Automation** under *Purpose*, then click the **Next** button to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter App Details" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image5.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=4dbe787b63460b6a421734654ca9e272" width="693" height="757" data-path="images/box/image5.png" />
    </Frame>
  </Step>

  <Step title="Select Authentication Method">
    Under *Create a Custom App: Step 2 of 2*, select **User Authentication (OAuth 2.0)**.

    Click the **Create App** button to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select Authentication Method" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image6.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=f70bd32a04098ac53a4b6f520863809d" width="652" height="712" data-path="images/box/image6.png" />
    </Frame>
  </Step>

  <Step title="Copy Your New Client ID">
    Your new Application's details will now be displayed.

    Scroll down to the **OAuth 2.0 Credentials** section, and copy your **Client ID** and store it safely.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy Application Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image8.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=6c8966abc33a5240be7d7cf3bbf4c5c9" width="801" height="469" data-path="images/box/image8.png" />
    </Frame>
  </Step>

  <Step title="Copy Your New Client Secret">
    Click the **Fetch Client Secret** button. This may prompt you for your 2-Step Verification code.

    Your **Client Secret** will now be displayed. Copy this and store it safely to be used in the next steps.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Copy Application Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image9.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=78aa815d53de8815bd3da18150813cec" width="758" height="432" data-path="images/box/image9.png" />
    </Frame>
  </Step>

  <Step title="Add a Redirect URI">
    Scroll down to the *Oauth 2.0 Redirect URIs* section.

    Enter the following Redirect URI: `https://api.stackone.com/connect/oauth2/box_iam/callback`

    Then click the **Add** button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Add a Redirect URI" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image7.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=004abe56f1504f4260044f859044f9c2" width="987" height="331" data-path="images/box/image7.png" />
    </Frame>
  </Step>

  <Step title="Select Application Scopes">
    Scroll down to the *Application Scopes* section.

    Select the following scopes:

    * Read all files and folders stored in Box
    * Manage users
    * Manage groups

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Select Application Scopes" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image10.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=7d2a4e70419e39301c9f742bc7b14045" width="872" height="609" data-path="images/box/image10.png" />
    </Frame>
  </Step>

  <Step title="Save Your Application">
    When complete with the previous steps, click the **Save Changes** button in the top right.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Save Your Application" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image11.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=3f067bf278100ae572950dc470e220a2" width="1375" height="733" data-path="images/box/image11.png" />
    </Frame>
  </Step>
</Steps>

## Connecting with StackOne

<Steps>
  <Step title="Enter Credentials">
    Upon reaching the Link Account page, enter your **Client ID** and **Client Secret** from the previous steps.

    Proceed by clicking the Connect button.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image12.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=a3544471ef5c025a63cc97131e157bb9" width="531" height="630" data-path="images/box/image12.png" />
    </Frame>
  </Step>

  <Step title="Approve App Connection">
    A new window will open, prompting you to log in to your Box account if you are not already logged in.

    A summary of the App you created will be displayed with its requested permissions.

    Click the **Grant access to Box** button to proceed.

    <Frame>
      <img className="rounded-md" style={{ margin: '0 auto', border: '1px solid #efefef' }} alt="Enter Credentials" src="https://mintcdn.com/stackone-hub-docs-confluence-api-token-update/r1CxNaPqqmzcLh_k/images/box/image13.png?fit=max&auto=format&n=r1CxNaPqqmzcLh_k&q=85&s=ead9a84290cf65f1d7dfcefc2176cf70" width="692" height="672" data-path="images/box/image13.png" />
    </Frame>
  </Step>
</Steps>

<br />

Congratulations, you're all set! If you face any issues with the steps mentioned above,
please contact us by emailing [integrations@stackone.com](mailto:integrations@stackone.com). We're always here to assist you!

## Available data

This integration has the following [IAM Resources](https://docs.stackone.com/reference/getting-started-with-your-api) available from the provider:

<ul>
  <li>Users</li>
  <li>Roles</li>
</ul>