Upload devices
Last updated November 19th, 2025
To upload devices to the Reseller Portal, you first need to prepare a CSV file that contains the IMEIs for the devices you want to upload. For details on how to properly format the CSV file, see Prepare a CSV file. Note that you can’t upload devices that are already registered in an inventory that you manage through Knox cloud services.
You can also upload devices using APIs. For details, see the Knox Deployment Program API reference v2.0.
Upload devices for a specific customer
After you’ve added a customer to the Knox Reseller Portal, you can upload one or more devices to their account.
-
On the Reseller Portal, go to the Customers page.
-
Under the COMPANY NAME/INTERNAL REFERENCE column, click a customer or MSP link. The customer details page opens. If you have MSP and reseller accounts that share the same MSP ID, other resellers can upload devices to your MSP account.
-
On the UPLOADS tab, click UPLOAD DEVICES. The Upload devices dialog opens.
-
Enter the following information:
-
Device CSV file — Click BROWSE and upload your CSV file. For details on how to properly format the CSV file, see Prepare a CSV file for a specific customer.
-
Sold-to-code (STC) alias (optional) — This field is available if you’ve added sold-to-codes on the Reseller Portal. If you’ve added multiple STCs, select the correct STC from the list.
You must specify an STC when uploading Enterprise Edition devices.
-
Order number (optional) — Enter the order number for the listed customer’s devices.
-
Order date (optional) — Select the date when the customer placed the order.
-
-
Click UPLOAD.
You no longer need to upload the same devices to customers if they want to use additional Knox services. See Re-uploading existing devices for more details.
Upload devices for multiple customers
You can also upload multiple devices for multiple customers in one operation.
-
On the Reseller Portal, click BULK ACTIONS.
-
Click UPLOAD DEVICES. The Upload devices page opens.
-
Click BROWSE and upload your CSV file. For details on how to properly format the CSV file, see Prepare a CSV file for multiple customers.
-
Click SUBMIT.
You must specify an STC when uploading Enterprise Edition devices. However, STC selection isn’t supported when uploading through BULK ACTIONS. For more information on how to upload Enterprise Edition devices, see Upload devices for a specific customer.
View device uploads
The uploads list displays the following:
| Component | Description |
|---|---|
| UPLOAD ID | A unique identifier associated with each batch of uploaded devices. |
| UPLOADED BY | The email of the admin who performed the upload. |
| ACCOUNT ID |
The account ID of the admin who performed the upload.This column only displays if you sign in with Samsung account for Business. |
| TOTAL DEVICES | The number of devices in the upload. |
| VERIFIED DEVICES | The number of devices authenticated and validated in the Knox system. |
| UPLOADED | The date and time of the upload. |
| STATUS | The state of the upload. |
Device upload status
The STATUS column of the UPLOADS tab shows one of four upload states:
| Status | Description |
|---|---|
| Completed | All devices in the list have been successfully uploaded to the customer's account. |
| In progress | Device upload is currently in progress. |
| Error |
All devices in the list have failed to upload. |
| Completed with error | Some devices in the list were uploaded to the customer account. |
If any upload errors occur, you can click the icon on the UPLOADS tab to review the reason, or to download a CSV file with greater detail of the issue.
Download device or uploads list as CSV
After you’ve uploaded devices to the Reseller Portal, you can download a list of devices or uploads as a CSV file.
-
Go to the Customers page.
-
Under the COMPANY NAME/INTERNAL REFERENCE column, click a customer or MSP link. The customer details page opens.
-
On the UPLOADS tab, click ACTIONS.
-
Select either Download uploads as CSV or Download devices as CSV. When you download devices, both IMEIs of any dual-SIM devices are included in the exported CSV file.
Re-uploading existing devices
If your customer deletes a device from one of their Knox services, but that device is still available in other Knox services, you can instruct your customer to re-register the device back into the service from which they deleted it. Re-registration simply involves performing a service-specific action in the Knox Admin Portal. For guidance, refer your customer to Re-register devices to your Knox cloud services.
If your customer deletes a device from Knox Guard, and they are unable to use a CSV file to recover the device, then you must help them re-upload it back into their account. Before re-uploading, you must first delete the device from the Reseller Portal. Note that when you delete a device, all of its configuration data is also erased.
After deleting the device from the Reseller Portal, you can add it back to the customer’s account by performing another device upload.
Common errors when re-uploading existing devices
The following are the possible errors you may encounter when you attempt to re-upload existing devices:
| Scenario | Upload status | Error message | Cause of error |
|---|---|---|---|
| Re-uploaded existing devices to a different Knox service for the same customer account. | Error | The same device(s) has/have been uploaded by the same reseller to the same customer. | Existing devices can't be re-uploaded to a customer account. |
| Re-uploaded existing devices to a different Knox customer account. | Error | The same device(s) has/have been uploaded by the same reseller to a different customer. | Existing devices already uploaded to a customer account can't be re-uploaded to another customer account. |
| New devices, along with existing devices, are uploaded to a customer account. | Completed with error |
The same device(s) has/have been uploaded by the same reseller to the same customer. The same device(s) has/have been uploaded by the same reseller to a different customer. |
New devices are successfully uploaded. Existing devices can't be re-uploaded to a customer account, which results in the error. |
You can click the icon on the UPLOADS tab to review the reason of the upload error, or to download a CSV file with greater detail of the issue.
On this page
Is this page helpful?