Join BoxWorks 2024 to discover what's possible with content and AI!

Register now!

Setup

Setup

Setting up a Custom Skill is a multi-step process.

Prerequisites

To set up a Custom App using OAuth 2.0 authentication, you will need to ensure you have access the Developer Console from your Box enterprise account. Alternatively, you may sign up for a developer account.

App creation steps

1. Log in to the Developer Console

Log into Box and navigate to the Developer Console. Select Create New App.

2. Create a Custom Skill

Select Box Custom Skill option from the list of application types. A modal will appear to prompt the next step.

Application selection screen

3. Provide a name

Finally, select a unique name for your application and click Create App.

App name form

Approval

You must select a folder that will trigger your skill before you can start using it.

Learn more about approving Custom Skills

Basic configuration

Before a Custom Skill can be enabled enabled on a folder, you must complete some additional configuration.

Invocation URL

For every file uploaded, copied, or moved into the selected folder, your skill will send a payload to a remote URL. This URL is called the invocation URL.

The Invocation URL can be any HTTP endpoint representing a server, development machine, or serverless function. The only requirement is that the URL is publicly available and accessible by Box servers. For this reason, localhost is not a valid address.

To set up the Invocation URL, navigate to the Configuration tab of the Developer Console and scroll down to the "Invocation URL" section.

App name form

Fill in a secure HTTPS address and save the form. The invocation URL is now configured.

File Extensions

By default a Custom Skill will trigger for any file type in the folder. To specify only selected file extensions to trigger the skill, navigate to the Configuration tab of the Developer Console and scroll down to the File Extensions section.

App name form