In Kio Cloud Device Management, you can import third-party devices into your device inventory. You can assign third-party gateway devices, such as Cisco Access Points, to their installation location in Kio Cloud Smart Location. For third-party BLE devices, Kio Cloud processes data from Bluetooth Low Energy devices that use one of the supported Kontakt.io BLE formats.
You add third-party devices by importing a CSV file. Once you add them, the devices appear in Device Management and are also available through the Device Management API.
Before you begin
To import external devices, you must be assigned the Device Management Administrator or Inventory Manager role.
About external device settings
For external devices, you can manage these settings from Kio Cloud Device Management:
Tags: a way to categorize or group devices.
Deployment Status: whether a device is deployed, not yet deployed, or has reached its end of life.
Notes: general information about a device.
Note: You can assign Infrastructure gateway devices, such as Cisco Access Points, to their install locations in Kio Cloud Smart Location.
How to import external devices
To import third-party devices into your Kio Cloud Device Management inventory, follow these steps.
Note: You can't import the same external device twice through Import External — a device whose Unique ID or MAC address already exists in your company is rejected as a duplicate and the import returns an error. To update devices you've already imported, edit each device from its profile, or use the export and import options. To update multiple devices at once, see Update multiple devices with a CSV file (bulk edit).
Step 1: Download CSV template
Download CSV template. The template includes example data. The CSV header row is required and can't be modified.
This table describes the third-party device data you need to import devices into Device Management. A valid mac, product (Product Name), category, and deployment.status are required.
| CSV header row | Device Management value | Description | Required | Example |
|---|---|---|---|---|
| uniqueId | Unique ID | Identifies the device: 4–32 letters or numbers, or a MAC address. If not provided, a value is generated automatically. | No | A12dBB |
| mac | MAC address | MAC address that uniquely identifies the device. Required format: XX:XX:XX:XX:XX:XX. On import, the MAC address is converted to uppercase. | Yes | 08:00:04:02:00:00 |
| alias | Notes | User-defined device details and information. | No | White Bulb |
| tags | Tags | Labels used to group or categorize devices. Letters and numbers only, no spaces, up to 32 characters each; separate multiple tags with a comma (up to 20 tags). | No | external,bulb,white |
| deployment.status | Deployment Status | The device's current lifecycle status. Allowed values: TO_BE_DEPLOYED, DEPLOYED, END_OF_LIFE. To assign gateway infrastructure devices (such as Cisco Access Points) to their install location in Smart Location, set the status to TO_BE_DEPLOYED — only devices set to TO_BE_DEPLOYED can be assigned to a location. | Yes | TO_BE_DEPLOYED |
| product | Product Name | Human-readable name of the product. | Yes | External device |
| productCode | Product code | Code that identifies the product type. | No | external_device |
| category | Device category | Where the device appears in Device Management, either the Tags or Infrastructure Inventory menu. Allowed values: TAG, INFRASTRUCTURE. Tags are BLE devices that are moving or wearable. Infrastructure devices are stationary, in a fixed position — for example, Cisco Access Points or other BLE-enabled Access Points. | Yes | TAG |
Step 2: Add external devices to CSV file
Keep the template's header row exactly as provided — it's the only part that's required. You don't need to fill in every column: uniqueId is optional, and if you leave it blank Device Management generates a value automatically. Complete the required columns — mac, product, category, and deployment.status — for each device.
Note: Before you edit the file, review the guidelines for using third-party apps to update the CSV file so it's formatted correctly.
Open the CSV file template in an editor such as Notes, Microsoft Excel, or Google Sheets.
-
Update the columns you need.
You can delete the columns you're not updating, but don't delete the uniqueId column or the header row.
Save the file as a CSV file and continue to the next step.
Step 3: Import the CSV file
Sign in to Kio Cloud, then select Device Management from the Launchpad.
From the Add Devices menu, select Import External, then select the CSV file with the external device data.
From the Success notification, select the option to view the CSV file.
From the file, review the two import columns appended to the file to verify the import.
Step 4: Assign third-party gateways to their install location
This step is optional. It places your third-party gateways — such as Cisco Access Points — on a floor plan so you can see them by location. You'll need the gateway's MAC address or Unique ID, and its Deployment Status must be set to To Be Deployed.
Third-party gateways are assigned on the Gateways tab. (BLE-only Kontakt.io Infrastructure devices are assigned separately, on the Infrastructure tab.)
Sign in to Kio Cloud, then select Smart Location from the Launchpad.
Go to the Campus, Building, and Floor where the gateway is installed.
-
From the upper-right corner, select Configure floor, then select the Gateways tab.
Select Assign new gateway, then select the room on the floor plan where the gateway is installed.
-
Select the gateway by its Unique ID or MAC address, then select Add.
The gateway is placed at the center of the visible floor plan. You can then select it and move it to its exact install location.
Search and locate external devices
Once you've imported your external devices, use the search and filter options on the Device Management Tags and Infrastructure menus to find them.
This example searches for an external Tag device by its MAC address.
This example uses the filter Criteria option to view external Tag devices, setting the Criteria to Product and selecting the model Example Beacon.
Important guidelines when using third-party apps to update the CSV file
Common third-party apps try to detect the data type in each column and format the numbers for you. This can backfire: the app may convert a large number to scientific notation, which then fails to import into Device Management.
To avoid this, follow these guidelines when you update the CSV file.
CSV file with Excel guidelines
In Excel, create a new blank workbook. From the toolbar, select the Data tab. In the Get External Data section, select From Text/CSV, locate and select the exported CSV file, then select Import.
For all columns, verify they are set to the Text type; do not select General or any other format. Setting the columns to a text format preserves the original data.
CSV file with Google Sheets guidelines
Create a new spreadsheet. Go to File > Import, select the CSV file, clear the Convert text to numbers, dates, and formulas checkbox, then select Import data.
CSV file with LibreOffice guidelines
During the import, from Other Options, (1) select the checkbox next to Format quotes field as text, (2) select all data, (3) Select Column Type, and (4) select Text.