Box API Provider Setup

To authenticate a Box connector instance you must register an app with Box and know the client_id, client__secret, and redirect_uri of the app. You will use these as the API Key, API Secret, and Callback URL when you authenticate a connector instance.

If you plan to use events, you also need to perform some additional webhook configuration.

Register an App

To set up the endpoint for Box, complete the setup steps described in this section.

  1. Via a web browser, go to

  2. Enter an application name.

  3. Select the type of Box application.

  4. Click Create Application.

  5. After the Box application is created, click Configure your application.

  6. Copy the client_id and the client_secret.

  7. Input a redirect_uri (your app’s callback URL).

  8. Select the appropriate Scopes for the application.


    “Read and write all files and folders” is required for most integrations.

    Box Connected App step 3

Set Up Webhooks

If you plan to use webhooks to monitor events, you must set up webhooks with Box.

To set up webhooks:

  1. Navigate to your app.
  2. Click Webhooks in the left nav area.


  3. Scroll to the bottom of the page, and then click Create a new Webhook.
  4. Complete the General Information.
  5. Add any events that you want to monitor to Event Triggers.
  6. In Endpoint URL, enter
  7. Maintain a Payload format of REST.
  8. Create the following Callback Parameters:

    Method Parameter Name Parameter Value
    Post itemType #item_type#
    Post newItemId #newitemid#
    Post userId #touserids#
    Post event #event_type#
    Post itemId #item_id#
  9. Click Save Webhook.


    As long as the minimum configuration fields are set properly, any other additional fields can also be specified. These additional fields will be sent along in the webhook call.

  10. Box requires you to submit a Support Request to enable webhooks for your app. You must complete this step before you will receive events from Box. Go to this URL:

  11. Scroll to the bottom of the page and click Contact Us to submit a request. You will need your API Key. This can be found at the bottom of the app configuration screen.

Related Links