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

Upload devices

Last updated September 2nd, 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

  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

  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 details icon to the right of the upload status 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.

On this page

Is this page helpful?