Box

🚀 Quickstart

Connect to Box with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Box. Nango doesn’t provide a test OAuth app for Box yet. You’ll need to set up your own by following these instructions. After that, make sure to add the OAuth client ID, secret, and scopes in the integration settings in Nango.

Authorize Box

Go to Connections -> Add Test Connection -> Authorize, then log in to Box. Later, you’ll let your users do the same directly from your app.

Call the Box API

Let’s make your first request to the Box API (fetch the profile of the currently signed-in user). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/2.0/users/me" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/2.0/users/me',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Box Integration Guides

Nango maintained guides for common use cases.

How to register your own Box OAuth app
Register an OAuth app with Box and obtain credentials to connect it to Nango

Official docs: Box API docs

🧩 Pre-built syncs & actions for Box

Enable them in your dashboard. Extend and customize to fit your needs.

Collaborations

Function name	Description	Type	Source code
`create-collaboration`	Create a collaboration in Box	Action	🔗 Github
`delete-collaboration`	Delete or archive a collaboration in Box	Action	🔗 Github
`get-collaboration`	Retrieve a single collaboration from Box.	Action	🔗 Github
`list-collaborations`	List collaborations from Box. Retrieves pending collaboration invites for this user.	Action	🔗 Github
`update-collaboration`	Update a collaboration in Box	Action	🔗 Github

Comments

Function name	Description	Type	Source code
`create-comment`	Create a comment in Box.	Action	🔗 Github
`delete-comment`	Delete or archive a comment in Box	Action	🔗 Github
`get-comment`	Retrieve a single comment from Box	Action	🔗 Github
`list-comments`	List comments for a file	Action	🔗 Github
`update-comment`	Update a comment in Box	Action	🔗 Github

Files

Function name	Description	Type	Source code
`copy-file`	Copy a file to a different folder in Box.	Action	🔗 Github
`delete-file`	Delete or archive a file in Box	Action	🔗 Github
`download-file`	Download file content from Box	Action	🔗 Github
`get-file`	Retrieve a single file from Box	Action	🔗 Github
`list-files`	List files from Box.	Action	🔗 Github
`update-file`	Update a file in Box. This can be used to rename or move a file.	Action	🔗 Github
`files`	Sync the metadata of specified files or folder paths from Box. A file or folder ID can be provided.	Sync	🔗 Github

Folders

Function name	Description	Type	Source code
`copy-folder`	Copy a folder and its contents to a different location in Box.	Action	🔗 Github
`create-folder`	Create a folder in Box	Action	🔗 Github
`delete-folder`	Delete or archive a folder in Box	Action	🔗 Github
`folder-content`	Fetches the top-level content (files and folders) of a folder given its ID. If no folder ID is provided, it fetches content from the root folder.	Action	🔗 Github
`get-folder`	Retrieve a single folder from Box.	Action	🔗 Github
`list-folders`	List folders from Box	Action	🔗 Github
`update-folder`	Update a folder in Box.	Action	🔗 Github

Search

Function name	Description	Type	Source code
`search`	Search for files, folders, and other content in Box	Action	🔗 Github

Users

Function name	Description	Type	Source code
`create-user`	Creates a user in Box. Requires an enterprise account.	Action	🔗 Github
`delete-user`	Deletes a user in Box. Requires an enterprise account.	Action	🔗 Github
`get-user`	Retrieve a single user from Box	Action	🔗 Github
`update-user`	Update a user in Box	Action	🔗 Github
`users`	Fetches a list of users from Box. Requires an enterprise account.	Sync	🔗 Github

Others

Function name	Description	Type	Source code
`collaborations`	Sync collaborations from Box	Sync	🔗 Github
`folders`	Sync folders from Box	Sync	🔗 Github

Overview

800+ APIs & Integrations

🚀 Quickstart

📚 Box Integration Guides

🧩 Pre-built syncs & actions for Box

Collaborations

Comments

Files

Folders

Search

Users

Others

Overview

800+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Box Integration Guides

​🧩 Pre-built syncs & actions for Box

​Collaborations

​Comments

​Files

​Folders

​Search

​Users

​Others

🚀 Quickstart

📚 Box Integration Guides

🧩 Pre-built syncs & actions for Box

Collaborations

Comments

Files

Folders

Search

Users

Others