Once you have your Developer Enterprise set up, getting your first application up and running is a fast process. That said, it's important that you use the best contact information and application information in case we ever need to reach out to you about your application or important changes.
When you are logged into your Developer Enterprise, you will notice an icon in the lower left corner that says, "Dev Console" — this is your shortcut to access your application(s) from anywhere in your Box account. If you're not seeing this icon, you can also access the Developer Console directly.
In the Developer Console, if you've not created any applications so far, you will see a prompt to get your first application created, go ahead and follow the prompt to get started. For the first step, you will see a selection of different Application Types that you can create. Most of our partners utilize the "Custom App" option for their integrations and for the purposes of this walkthrough, we will use that as well. More on the different application types and which option is best for you can be found in the Application Types Guide.
After you select, "Custom App" you will be presented with a selection of different Authentication Methods that your application can utilize. The majority of the applications that our partners build utilize the "User Authentication (OAuth 2.0)" authentication method to allow customers to connect their Box accounts to integrations, so for the purpose of this guide, we will be using this flow. Depending on the application function, you may benefit from choosing a different authentication type — you can read more about the differences in our Authentication Types Guide.
For the "App Name" you can choose what you'd like during this step — this name can be changed later and will not be publicly available to Box customers until you choose to publish your application. Note that this is the identifier that both customers and admins will see further down the road when the app is published, so utilizing an easily recognizable name is best. Once that's done, click, "Create App" and you're all set! You will be taken to the developer interface for the application where most of the internal settings of your application live.
We'll cover most of the application settings in later articles, but one section worth paying attention to at this stage is the "General Settings" tab at the top of the page. This is where you will see a few important items:
-
App Name — This is the name that you set during the creation of the app, and can be changed as needed.
-
Contact Email — By default, this is set to the developer of the application when the app is created, but it's worth noting that once you choose to publish your integration, this email will be publicly visible to Box users viewing your application in the App Center. We recommend changing this to a support email address for users to reach out to in case they have any issues with the integration.
-
Collaborators — In this section, you can add other developers that may be working on this integration so that they have access to the developer interface for the application in case they need to adjust settings during the development. One important note is that any accounts you add here need to be valid Box users already. If they currently do not have Box accounts, you can create accounts for them in your Developer Enterprise. You can read more about adding users to an enterprise on our Support site section on Adding Users.
For any questions, please contact our Partners team at integrate@box.com