Home / Knox Deployment Program / How-to guides / Manage devices /

Upload devices

Last updated November 6th, 2025

On this tab

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.

  1. On the Reseller Portal, go to the Customers page.

  2. 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.

    Example company link on Customers page

  3. On the UPLOADS tab, click UPLOAD DEVICES.

  4. 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.

  5. Click UPLOAD.

Upload devices for multiple customers

You can also upload multiple devices for multiple customers in one operation.

  1. On the Reseller Portal, click BULK ACTIONS.

  2. Click UPLOAD DEVICES.

  3. 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.

  4. 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.

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 issues occur, you can select the icon to review the issue in greater detail.

Upload status error details

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.

  1. Go to the Customers page.

  2. Under the COMPANY NAME/INTERNAL REFERENCE column, click a customer or MSP link. The customer details page opens.

  3. On the UPLOADS tab, click ACTIONS.

  4. 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.

This document was updated for the Knox Partner Program 25.11 UAT.

On this tab

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.

  1. On the Reseller Portal, go to the Customers page.

  2. 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.

    Example company link on Customers page

  3. On the UPLOADS tab, click UPLOAD DEVICES. The Upload devices dialog opens.

The Upload devices dialog.

  1. 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.

  2. Click UPLOAD.

You no longer need to upload the same devices to customers if they want to use additional Knox services.

Upload devices for multiple customers

You can also upload multiple devices for multiple customers in one operation.

  1. On the Reseller Portal, click BULK ACTIONS.

  2. Click UPLOAD DEVICES. The Upload devices page opens.

The BULK ACTIONS - Upload devices page.

  1. 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.

  2. 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.

Uploads that result in Error aren’t saved in the uploads list. You can find the upload event in the Activity log.
Completed with error Some devices in the list were uploaded to the customer account.

If any issues occur, you can select the icon to review the issue in greater detail.

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.

  1. Go to the Customers page.

  2. Under the COMPANY NAME/INTERNAL REFERENCE column, click a customer or MSP link. The customer details page opens.

  3. On the UPLOADS tab, click ACTIONS.

  4. 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.

Is this page helpful?