In this tutorial, you will learn how to create an app within Torii. You will send this app data about users, licenses, and usage using Torii's REST APIs. This tutorial should take approximately 10 minutes, even if you have no prior experience building custom integrations. By the end of this guide, you will have a custom app called **Hello World** with data about users and their usage of licenses in the app. You can follow the documentation for detailed instructions and screenshots or watch this tutorial video on building your custom integration.

### Prerequisites Before you begin, ensure you complete the following steps: 1. Ensure you have a trial or active subscription to Torii. ### Step 1: Create your API Key using the steps in [Getting Started with the Torii API](https://developers.toriihq.com/docs/getting-started) 1. Follow the steps to create your API key. ### Step 2: Create a custom app in Torii This example uses a **Custom Application** called **Hello World**. 1. In the **Settings** tab view, select **[Custom Applications](https://app.toriihq.com/team/settings/customApps)**, then select **Add application** from the right side of the page.

2. Fill out details for the app and select **Add Application**.

### Step 3: Add a custom integration for your app 1. Select the **Integrations** tab and scroll to the bottom of the page. Select the **Add Custom Integration** tile.

2. A dialog box will pop up. Select the **Hello World** app you just added to Torii.

3. Select **Add Integration**.

4. Select **Copy App account ID**. This ID will be used in our API calls. > 📘 Tip > > You can retrieve this App account ID at any time in the future. If you lose the App account ID, you can navigate to the integrations page and hover over the corresponding app tile.

### Step 4: Use the [Get URL call](https://developers.toriihq.com/reference/getfilesurl) to create the file 1. Within the **API Explorer**, navigate to **[Get URL](https://developers.toriihq.com/reference/getfilesurl)**. Within that page, under **QUERY PARAMS**, change the **name** query string parameter to **hello\_world**. 2. On the right side of the page, set the **Authentication** token value as your App Account ID that you copied in the previous section.

2. Set the **type** query string parameter to **customIntegrationData** using the example value provided.

3. Select the **Try It** button within the **cURL** section on the right side of your page. ![](https://files.readme.io/5268aa5-get_url_configured_try_it.png) 4. This should result in a generated response that will include the **url** and the **filePath** to be used in the next steps. **Copy the entire response** to a text editor or similar tool where it will be accessible. You will need the data in this response in the upcoming steps. **You will only have 5 minutes to submit the next request** > 📘 Tip > > You can use a tool like [JSON Editor Online](https://jsoneditoronline.org/#left=local.vetepe) to temporarily store your responses so you can use the data in API Explorer. ### Step 5: Upload JSON file that contains your users, licenses, and usage dataStep Below is a button that allows you to paste the value from **url** that you received in your **Get URL** response directly into a Postman request. This [guide](https://developers.toriihq.com/docs/using-postman-to-validate-your-json-payload) provides additional information on using Postman to validate your JSON payload. Select the 'Upload Users and Licenses' request and either use the example JSON or format the data you require. See Screenshot below.

[![Run in Postman](https://run.pstmn.io/button.svg)](https://app.getpostman.com/run-collection/19631555-9c6c389b-3e02-4a51-a1cc-237adf8a64e3?action=collection%2Ffork\&source=rip_markdown\&collection-url=entityId%3D19631555-9c6c389b-3e02-4a51-a1cc-237adf8a64e3%26entityType%3Dcollection%26workspaceId%3D0e91e34f-cc1a-4233-b040-d5ddb2c7aa90) ### Step 6: Use the [GET File ID](https://developers.toriihq.com/reference/postfiles) request 1. Navigate to [GET File ID](https://developers.toriihq.com/reference/postfiles) and find the **BODY PARAMS** section. In the **path string**, paste the **filePath** value that we generated in the **GET URL** response in **Step 4**. The value for **type** should always be **customIntegrationData** - do not change the default in the API Explorer, and ensure this is set in your code when building. Select **Try It!**

2. In the response, look for an **HTTP 201** success code, with the **id** of the file in the body. Copy this **id** value for use in the next step. ![](https://files.readme.io/a5fa9a6-get_file_id_success_201_response_with_id_blurred.png) ### Step 7: Use [Sync Integration](https://developers.toriihq.com/reference/putservicessynccustom) to push the contents of the file to the Torii DB so it can be viewed through the console 1. Navigate to the [Sync Integration](https://developers.toriihq.com/reference/putservicessynccustom) page. Under **BODY PARAMS**, paste your **id** value from the **Step 6** into the **idFile string** field. Paste **App account ID** from **Step 3**. Select **Try It**.

2. Look for an **HTTP 200** response code with success set to **true** as in the screenshot below.

3. Within Torii, navigate to the **Integrations** tab. Find the tile for your custom integration, **Hello World**. Confirm that you see a green check for your custom integration. This indicates a successful connection.

4. To confirm that your example usage data was pushed, navigate to the **Licenses** tab and find **Hello World** from the list of applications. You should see active and inactive licenses listed on the **Licenses** page.

> 👍 Congratulations! > > You successfully created and integrated an app with Torii! You also sent data about users, licenses, and usage. That's one less shadow IT app in your ecosystem (even if you built it in the first place).