---
title: "Box Connector | Lansweeper Platform"
slug: "box-connector"
description: "Manage Box files with Developer Tokens and OAuth 2.0 for secure access. Learn to authenticate and integrate Box API effectively."
updated: 2026-07-17T15:52:01Z
published: 2026-07-17T15:52:01Z
canonical: "docs.lansweeper.com/box-connector"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lansweeper.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box Connector

Note on third‑party tools

              

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

[Box](https://www.box.com/) is a file sharing platform that allows teams to collaborate and share files with one another. The Box component allows you to create, list, fetch, move, or delete files and folders in a customer's Box account.

## API Documentation

This component was built using the [Box REST API](https://developer.box.com/reference/)

## Connections

### Developer Token

Developer Token connection for Box

A **Developer Token** is a short-lived (60-minute) token that can be used for testing purposes. Developer tokens allow access to the Box API for a personal Box account only.

              Production Authentication

              

When an integration is ready for production, an [OAuth 2.0](/docs/box-connector#oauth2) connection is required to authenticate customer Box accounts. Testing can also be performed with OAuth 2.0.

#### Prerequisites

- A [Box account](https://www.box.com/)
- Access to the [Box Developer Console](https://app.box.com/developers/console)

#### Setup Steps

To generate a developer token:

1. Navigate to the [Box Developer Console](https://app.box.com/developers/console)
2. Select **Create New App**
3. Choose **Custom App** and click **Next**
4. Select **User Authentication (OAuth 2.0)** and click **Next**
5. Enter an app name and click **Create App**
6. In the app's **Configuration** tab, scroll to the **Developer Token** section
7. Click **Generate Developer Token**
8. Copy the generated token (valid for 60 minutes)

For more information, refer to the [Box Developer Token documentation](https://developer.box.com/guides/authentication/tokens/developer-tokens/).

#### Configure the Connection

- Enter the developer token value into the **Developer Token** field of the connection configuration

              Token Expiration

              

Developer tokens expire after 60 minutes. Generate a new token if authentication fails due to expiration.

| Input | Comments | Default |
| --- | --- | --- |
| Developer Token | A short-lived developer token for testing purposes. Obtain from [Box Developer Console](https://app.box.com/developers/console). |  |

### OAuth 2.0

OAuth 2.0 connection for Box

To connect to Box using OAuth 2.0, create a Box OAuth 2.0 app to authorize the integration to access customer Box accounts.

Refer to the [Box OAuth 2.0 setup guide](https://developer.box.com/guides/authentication/oauth2/oauth2-setup/) for detailed information.

#### Prerequisites

- A [Box account](https://www.box.com/)
- Access to the [Box Developer Console](https://app.box.com/developers/console)

#### Setup Steps

1. Navigate to the [Box Developer Console](https://app.box.com/developers/console)
2. Click **Create New App**
3. Select **Custom App** and click **Next**
4. Select **User Authentication (OAuth 2.0)** and click **Next**
5. Enter an app name and click **Create App**
6. In the app's **Configuration** tab, configure the OAuth settings:
  - Copy the **Client ID** and **Client Secret** values
  - Under **OAuth 2.0 Redirect URI**, add `https://oauth2.flowbuilder.eu.lansweeper.com/callback` for EU sites or `https://oauth2.flowbuilder.us.lansweeper.com/callback` for US sites
  - Under **Application Scopes**, select the appropriate permissions:
    - For full access, select **Write all files and folders stored in Box**
    - For read-only access, select **Read all files and folders stored in Box**
    - Refer to [Box scopes documentation](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/) for more granular permissions
  - Leave **CORS Domains** blank
7. Click **Save Changes**

#### Configure the Connection

- Enter the **Client ID** and **Client Secret** from the Box app configuration
- For **Scopes**, either:
  - Leave blank to use the **Application Scopes** configured in the Box app
  - Enter specific scopes as a space-separated list (e.g., `root_readwrite manage_webhook`)
  - Refer to [Box scopes documentation](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/) for available scopes

              Box Enterprise Features

              

Some Box features require an Enterprise account. Ensure the Box account has appropriate subscription level for the required functionality.

#### App Authorization

Box gives enterprise IT administrators explicit control over which third-party apps can access their organization's data. This is not a vendor review process. It is an enterprise access control step that a Box administrator at the customer's organization must complete before their users can connect.

Box enterprise accounts require an administrator to explicitly authorize a custom app before any users in the organization can authenticate. This is a **hard requirement**: without admin authorization, only the developer's own Box account can connect. All other users receive an error when attempting to authenticate.

Personal (non-enterprise) Box accounts do not require this step.

#### Granting App Authorization

A Box enterprise administrator must authorize the app using the app's **Client ID**:

1. In the [Box Admin Console](https://app.box.com/master), navigate to **Apps** → **Custom Apps Manager**
2. Click **Add App**
3. Enter the **Client ID** from the Box app's **Configuration** tab
4. Click **Next**, review the requested scopes, and select **Authorize**

Once authorized, users within the enterprise organization can authenticate with the integration.

              Re-authorization Required After App Recreation

              

If the Box app is deleted and recreated, a new Client ID is generated and admin authorization must be repeated.

This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works [here](/docs/oauth-20-connections).

| Input | Comments | Default |
| --- | --- | --- |
| Scopes | A space-delimited set of one or more scopes. Leave blank to use your app's configured default scopes. See [Box OAuth Scopes](https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/) for available options. | root_readwrite manage_webhook |
| Client ID | The OAuth 2.0 client ID from your Box app configuration. Obtain from [Box Developer Console](https://app.box.com/developers/console). |  |
| Client Secret | The OAuth 2.0 client secret from your Box app configuration. Obtain from [Box Developer Console](https://app.box.com/developers/console). |  |

## Triggers

### Managed Webhook

Receive and validate webhook requests from Box. Automatically creates and manages a webhook subscription when the instance is deployed, and removes the subscription when the instance is deleted.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| Target ID | The unique identifier of the file or folder that will trigger the webhook. |  |
| Target Type | The type of item that will trigger the webhook (file or folder). |  |
| Trigger Type | Select which event types will trigger this webhook. See [Box Events](https://developer.box.com/guides/webhooks/triggers) for available options. |  |
| Primary Signature Key | A signature key used to validate webhook requests. See [Box Webhook Signatures](https://developer.box.com/guides/webhooks/handle/verify-signatures/) for details. |  |
| Secondary Signature Key | A signature key used to validate webhook requests. See [Box Webhook Signatures](https://developer.box.com/guides/webhooks/handle/verify-signatures/) for details. |  |

### Manual Webhook

Receive and validate webhook requests from Box for manually configured webhook subscriptions.

### New and Updated Files

Checks for new and updated files in a specified folder on a configured schedule.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| Folder ID | The unique identifier of the folder. |  |

### New File Comments

Checks for new comments on a specified file on a configured schedule.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| File ID | The unique identifier of the file. |  |

### New Folders

Checks for new folders in a specified folder on a configured schedule.

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| Folder ID | The unique identifier of the folder. |  |

## Actions

### Add Shared Link to File

Adds a shared link to a file

| Input | Comments | Default |
| --- | --- | --- |
| File ID | The unique identifier of the file. |  |
| Shared Link | The URL of the shared link. |  |
| Shared Link Access | The level of access for the shared link. Values: open, company, collaborators. See [Box Shared Links](https://developer.box.com/guides/shared-links/) for details. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Shared Link Permissions | The permissions for the shared link (file). Specify which actions are allowed. See [Box Shared Link Permissions](https://developer.box.com/reference/put-files-id/#request-body) for details. | `{ "can_download": true, "can_edit": true, "can_preview": true}` |
| Shared Link Vanity Name | The custom vanity name for the shared link URL. Creates a URL like https://app.box.com/v/your-vanity-name. |  |
| Connection | The Box connection to use. |  |

### Add Shared Link to Folder

Adds a shared link to a folder

| Input | Comments | Default |
| --- | --- | --- |
| Folder ID | The unique identifier of the folder. |  |
| Shared Link | The URL of the shared link. |  |
| Shared Link Access | The level of access for the shared link. Values: open, company, collaborators. See [Box Shared Links](https://developer.box.com/guides/shared-links/) for details. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Shared Link Permissions Folder | The permissions for the shared link (folder). Specify which actions are allowed. See [Box Shared Link Permissions](https://developer.box.com/reference/put-folders-id/#request-body) for details. | `{ "can_download": true, "can_preview": true}` |
| Shared Link Vanity Name | The custom vanity name for the shared link URL. Creates a URL like https://app.box.com/v/your-vanity-name. |  |
| Connection | The Box connection to use. |  |

### Copy Object

Copy a Folder or File from one path to another

| Input | Comments | Default |
| --- | --- | --- |
| From Path | The full path to the source file or folder. Must include a leading forward slash (/). |  |
| To Path | The full path to the destination location including the new filename. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Create Folder

Create a Folder at the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Create Webhook

Create a webhook to send data from Box to an instance URL

| Input | Comments | Default |
| --- | --- | --- |
| Webhook URL | The URL where webhook events will be sent. Reference a flow's URL from the trigger payload. |  |
| Target ID | The unique identifier of the file or folder that will trigger the webhook. |  |
| Target Type | The type of item that will trigger the webhook (file or folder). |  |
| Trigger Type | Select which event types will trigger this webhook. See [Box Events](https://developer.box.com/guides/webhooks/triggers) for available options. |  |
| Primary Signature Key | A signature key used to validate webhook requests. See [Box Webhook Signatures](https://developer.box.com/guides/webhooks/handle/verify-signatures/) for details. |  |
| Secondary Signature Key | A signature key used to validate webhook requests. See [Box Webhook Signatures](https://developer.box.com/guides/webhooks/handle/verify-signatures/) for details. |  |
| Connection | The Box connection to use. |  |

### Delete Instance Webhooks

Delete all Box webhooks that point to a flow in this instance

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |

### Delete Object

Delete a Folder or File at the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Delete Webhook

Delete a webhook by ID

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| Webhook ID | The unique identifier of the webhook. |  |

### Download File

Download the file at the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Find File For Shared Link

Returns the file represented by a shared link

| Input | Comments | Default |
| --- | --- | --- |
| Shared Link | The URL of the shared link. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Fields | A comma-separated list of attributes to include in the response. See [Box File Fields](https://developer.box.com/reference/resources/file/) for available options. |  |
| Connection | The Box connection to use. |  |

### Find Folder For Shared Link

Returns the folder represented by a shared link

| Input | Comments | Default |
| --- | --- | --- |
| Shared Link | The URL of the shared link. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Fields | A comma-separated list of attributes to include in the response. See [Box File Fields](https://developer.box.com/reference/resources/file/) for available options. |  |
| Connection | The Box connection to use. |  |

### Get Current User

Get the information and metadata of the user that is currently logged in

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |

### Get File Download URL

Get a URL to download the file at the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Get Shared Link For File

Gets the shared link for a file

| Input | Comments | Default |
| --- | --- | --- |
| File ID | The unique identifier of the file. |  |
| Connection | The Box connection to use. |  |

### Get Shared Link For Folder

Gets the shared link for a folder

| Input | Comments | Default |
| --- | --- | --- |
| Folder ID | The unique identifier of the folder. |  |
| Connection | The Box connection to use. |  |

### List Folder

List Folder contents at the specified path.

| Input | Comments | Default |
| --- | --- | --- |
| Fetch All | When true, retrieves all results using automatic pagination. | false |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Fields/Metadata | Comma-separated attributes to include in the response. Supports metadata queries (e.g., metadata.enterprise_12345.contractTemplate). See [Box File Fields](https://developer.box.com/reference/resources/file--full) for available options. |  |
| Limit | The maximum number of items to return (1-1000). |  |
| Marker | The pagination marker returned by a previous request to retrieve the next page of results. |  |
| Offset | The position to start returning results from (zero-based index). |  |
| Connection | The Box connection to use. |  |

### List Folder (Deprecated)

List Folder contents at the specified path. This version of the action is being deprecated. Please replace action with List Folder.

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Limit | The maximum number of items to return (1-1000). |  |
| Marker | The pagination marker returned by a previous request to retrieve the next page of results. |  |
| Offset | The position to start returning results from (zero-based index). |  |
| Connection | The Box connection to use. |  |

### List Webhooks

List all webhooks configured in Box, including those for other integrations

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| Limit | The maximum number of items to return (1-1000). |  |
| Marker | The pagination marker returned by a previous request to retrieve the next page of results. |  |
| Fetch All | When true, retrieves all results using automatic pagination. | false |
| Show Only Instance Webhooks | Show only webhooks that point to this instance | true |

### Move Object

Move a Folder or File from one path to another

| Input | Comments | Default |
| --- | --- | --- |
| From Path | The full path to the source file or folder. Must include a leading forward slash (/). |  |
| To Path | The full path to the destination location including the new filename. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Path Details

Get detailed information about folders/files in the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| Connection | The Box connection to use. |  |

### Raw Request

Send raw HTTP request to Box

| Input | Comments | Default |
| --- | --- | --- |
| Connection | The Box connection to use. |  |
| URL | Input the path only (/2.0/folders), The base URL is already included (https://api.box.com). For example, to connect to https://api.box.com/2.0/folders, only /2.0/folders is entered in this field. |  |
| Method | The HTTP method to use. |  |
| Data | The HTTP body payload to send to the URL. |  |
| Form Data | The Form Data to be sent as a multipart form upload. |  |
| File Data | File Data to be sent as a multipart form upload. |  |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. |  |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. |  |
| Header | A list of headers to send with the request. |  |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request |  |
| Debug Request | Enabling this flag will log out the current request. | false |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |

### Remove Shared Link from File

Removes a shared link from a file

| Input | Comments | Default |
| --- | --- | --- |
| File ID | The unique identifier of the file. |  |
| Connection | The Box connection to use. |  |

### Remove Shared Link from Folder

Removes a shared link from a folder

| Input | Comments | Default |
| --- | --- | --- |
| Folder ID | The unique identifier of the folder. |  |
| Connection | The Box connection to use. |  |

### Update Shared Link on File

Updates a shared link on a file

| Input | Comments | Default |
| --- | --- | --- |
| File ID | The unique identifier of the file. |  |
| Shared Link | The URL of the shared link. |  |
| Shared Link Access | The level of access for the shared link. Values: open, company, collaborators. See [Box Shared Links](https://developer.box.com/guides/shared-links/) for details. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Shared Link Permissions | The permissions for the shared link (file). Specify which actions are allowed. See [Box Shared Link Permissions](https://developer.box.com/reference/put-files-id/#request-body) for details. | `{ "can_download": true, "can_edit": true, "can_preview": true}` |
| Shared Link Vanity Name | The custom vanity name for the shared link URL. Creates a URL like https://app.box.com/v/your-vanity-name. |  |
| Connection | The Box connection to use. |  |

### Update Shared Link on Folder

Updates a shared link on a folder

| Input | Comments | Default |
| --- | --- | --- |
| Folder ID | The unique identifier of the folder. |  |
| Shared Link | The URL of the shared link. |  |
| Shared Link Access | The level of access for the shared link. Values: open, company, collaborators. See [Box Shared Links](https://developer.box.com/guides/shared-links/) for details. |  |
| Shared Link Password | The password for the shared link, if one is set. |  |
| Shared Link Permissions Folder | The permissions for the shared link (folder). Specify which actions are allowed. See [Box Shared Link Permissions](https://developer.box.com/reference/put-folders-id/#request-body) for details. | `{ "can_download": true, "can_preview": true}` |
| Shared Link Vanity Name | The custom vanity name for the shared link URL. Creates a URL like https://app.box.com/v/your-vanity-name. |  |
| Connection | The Box connection to use. |  |

### Upload File

Upload a file to the specified path

| Input | Comments | Default |
| --- | --- | --- |
| Path | The full path to the file or folder. Must include a leading forward slash (/). |  |
| File Contents | The file content to upload. Accepts text, binary data (images, PDFs), or output from a previous step. |  |
| Connection | The Box connection to use. |  |