> ## Documentation Index
> Fetch the complete documentation index at: https://stackone-hub-claude-issue-384-20260409-1436.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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image1.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=497c3434cf6b38192ee03589ce782e99" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image2.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=8c9cb6b44c04c13c82d47eafebdd13e5" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image3.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=7ae6454203d1ecbdc1a0b111119d2802" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image4.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=2fd296a9b97bff2b7122df11afb734e2" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image5.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=8cc6926563106a342fb310e06d87178a" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image6.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=627607b50548d8859861c1a661745372" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image8.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=92b772a4d80c0effe09774de91df3109" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image9.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=fdd6bcc0be9aa0c7ad594e034042ab40" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image7.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=34d6761c3569014374f081ea18aecd4e" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image10.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=5448d32b7859ee7f911905a0f54ad700" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image11.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=38650b483cae9cd8e896e8883b62cf1a" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image12.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=1666a2a8c9ad84da8298e10fdb8e179f" 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-claude-issue-384-20260409-1436/TClBDBl2qSn4XKCa/images/box/image13.png?fit=max&auto=format&n=TClBDBl2qSn4XKCa&q=85&s=a1790899e95f2e5b6fd2b3ba231dd6df" 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>
