Note: To start using Box API you need to set up a Custom App using server-side authentication View detailed instructions to set up the integration here: https://support.freshservice.com/en/support/solutions/folders/50000000561 1. App creation - Log into Box and navigate to Developer Console > Create New App. - Select Custom App from the list of application types. A modal will appear to prompt a selection for the next step. - Select Server Authentication (with JWT) to verify application identity with a key pair. Then, provide a name for your application and click Create App. Note: Once you make a selection, you will not be able to change to a different authentication method without creating a new application. 2. Basic configuration - Application Access: To work with existing Managed Users of the enterprise, navigate to Developer console > Configuration Tab > Application Access Settings. Set to App Access + Enterprise Access. - Application Scopes: Select all the scopes listed under Application scopes in order to perform app actions. See the scopes guide for detailed information on each option here (https://developer.box.com/guides/api-calls/permissions-and-errors/scopes/) 3. Public and Private Key Generation Once a Custom App is created leveraging Server Authentication with JWT, a key pair can be generated via the Configuration tab within the Developer Console. - To generate the keypair configuration file, navigate to Developer Console > Configuration tab > Add and Manage Public Keys section - Click the Generate a Public/Private Keypair button to have Box generate a keypair for you. This will trigger the download of a JSON configuration file that you can use in your application as input to Box config param. Note: For security reasons, Box will not store your private key. If you lose your private key, you will need to reset the entire key pair. 4. App Authorization Before the application can be used, a Box Admin needs to authorize the application within the Box Admin Console. - Navigate to Developer Console > Authorization Tab. - Click Submit and Review to send an email to your Box enterprise Admin for approval. 5. App Installation Parameter To install and authenticate the app you need to provide the following input: - Box Config - Copy it from the JSON file downloaded while generating a Public and private key pair The following two parameters are required for attaching documents to your Freshservice tickets as either a note or directly to a new ticket. - Freshservice Domain - The domain of your Freshservice tenant. Example: demo.freshservice.com - Freshservice API Key - Login to your Freshservice tenant. Click on your profile icon then "Profile Settings" on the right side pane, under "Your API Key" complete the captcha and copy your API key.