Skip to content

Adding and removing devices

This page explains the process of adding Internet Protocol (IP) or Bluetooth® Low Energy (LE) devices to your nRF Cloud account.

IP devices

To add an IP device, associate it with your account. This happens automatically during the onboarding process only when using the ProvisionDevices endpoint or auto-onboarding.

If you are using Just-in-Time provisioning (JITP), you must manually associate the device with your account using either the nRF Cloud portal or the AssociateDevice endpoint.

An IP device knows whether it is associated by finding {"pairing":{"state":"paired"}} in its device shadow. Devices using the nRF Cloud library attempt to do this automatically. See the MQTT API documentation for more information.

Bluetooth LE devices

You can add Bluetooth LE devices to your account using either the nRF Cloud portal or the AddPeripheral endpoint.

Adding a Bluetooth LE device is not the same as adding an IP device, as there is no association process for a Bluetooth LE device. Instead, you are connecting the device to an associated gateway. The added device is known to nRF Cloud, and you can view its data by calling the FetchDevice or ListDevices endpoints.

Removing devices from your account

To remove a device from your account, use either the nRF Cloud portal or the DeleteDevice endpoint.

Removing the device also removes any associated data.

Note

Deleting a device removes its association. If you have claimed a device and used provisioning commands or auto-onboarding to add it to nRF Cloud, the following steps, as well as the DeleteDevice endpoint, do not affect the device's claim status.

Deleting devices using the nRF Cloud portal

To remove a device from your account:

  1. Log in to the nRF Cloud portal.
  2. Select Devices from the left navigation bar.

  3. You can delete one or more devices from the Devices overview, or a single device from that device's page:

    • To delete one or more devices from the device overview:

      1. Select the checkbox next to one or more devices that you want to delete.

      2. Click Delete.

        A pop-up opens asking for confirmation.

      3. Click OK.

    • To delete a single device from its own page:

      1. Click the device name. The device's own page opens.

      2. Click Delete Device.

        A pop-up opens asking for confirmation.

      3. Click OK.

The device and its associated data are now removed.