Register Devices

Login to Suite API Docs

The next step is to configure your device in the IoT Hub. To achieve this you will have to register a device in the IoT Hub. This defines the properties of the device identity.

We recommend to open the Suite API Docs for the Device Registry in a new browser window:

Suite API Docs: Device Registry

First login into the Suite API Docs by clicking the Authorize button. Please enter the credentials you have retrieved from the IoT Suite Portal. Please use the device-registry credentials. The username will be of the format device-registry@YOUR_TENANT.

Add Device Registration

The following steps are needed for the registration of a new device. Device registration is done by performing a HTTP POST request which contains the device identity information.

  1. Navigate to the devices section and select the POST operation.

  2. Press the Try it out button.

  3. Enter your tenant-id in the tenant-id field (the tenant-id can be retrieved from the IoT Suite Portal as well).

  4. Check the json body of the request. You should make sure that the device-id is not already taken by another device of your subscription.

  5. In addition to the mandatory fields (enabled, device-id) additional custom fields can be added.

  6. Finally run the request by hitting the Execute button.

  7. Verify that the request was successful (Code 201).

Your device has now been registered with the IoT Hub.