Box - How do I set up my partner credentials for OAuth?

Last updated: February 4, 2026

Overview

This guide will walk you through the steps generate your client credentials within Box and input them into the Merge Dashboard. Please note that generating your own client credentials is not required for the Box integration to work, but rather an optional step to create your own OAuth Application.

Pre-requisites

In order to complete the steps below, you must have a Box developer account. If you do not, you can sign up for a free Box trial to get started! Box provides documentation on creating developer accounts on their developer site.

Instructions

Step 1: Create a Box Developer App

  1. Login to your Box application developer console.

  1. In the top right, click New App.

image.png

  1. On the Create a New App popup, name your application.

  2. Select an App Type of OAuth 2.0.

image.png

  1. Click Create App to create your application.

Step 2: Configure Your Application

  1. On the Configuration tab of your Box application, fill out the appropriate fields under App Details.

    1. Purpose: Integration

    2. Categories: Productivity

    3. Which external system are you integration with: Merge

    4. Who is building this application: Partner

    5. Please Specify: {Your organization name}

image.png

  1. Still on the Configuration tab of your Box application, scroll down to the OAuth 2.0 Redirect URIs section.

  2. Add the following Redirect URI: https://app.merge.dev/oauth/callback

    image.png

  1. Still on the Configuration tab of your Box application, scroll down to the Application Scopes section.

  2. Enable the following scopes for your Box app:

    1. Read all files and folders stored in Box (required)

    2. Write all files and folders stored in Box (optional)

      1. Necessary to download files and folders

    3. Manage users (optional)

      1. For ACLs

    4. Manage groups (optional)

      1. For ACLs

    image.png

  3. Save your changes.

Step 3: Add your Box client credentials to Merge

  1. On the Configuration tab of your Box developer app you created, locate the OAuth 2.0 Credentials section. Copy your Client ID and Client Secret.

    image.png

  2. On the Merge Dashboard, navigate to the Integrations tab.

  3. Under File Storage, identify the Box integration.

  4. Enable the integration using the toggle on the right.

    image.png

  5. Click Set up organization-level credentials.

  6. Enter the following information in the corresponding fields