---
title: "Creates the device."
method: POST
path: "/api/devices"
tags: ["IoT Devices"]
---

# Creates the device.

`POST /api/devices`

## Request body

- DeviceDetails — Device details.
  - `deviceID` string, nullable — The device identifier.
  - `deviceName` string, required — The name of the device.
  - `modelId` string, required — The model identifier.
  - `modelName` string, nullable — The model name. (For AWS)
  - `imageUrl` string, uri, nullable — The device model image Url.
  - `isConnected` boolean — `true` if this instance is connected; otherwise, `false`.
  - `isEnabled` boolean — `true` if this instance is enabled; otherwise, `false`.
  - `statusUpdatedTime` string, date-time — The status updated time.
  - `tags` object, nullable — List of custom device tags and their values.
  - `isLoraWan` boolean — `true` if this instance is lorawan; otherwise, `false`.
  - `labels` LabelDto[], nullable — Labels
    - `name` string, required
    - `color` string, required

## Response `200`

Success

---

[API](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api.md) · [All operations](https://skmtc.net/cgi-fr/apis/azure-iot-hub-portal-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cgi-fr/azure-iot-hub-portal-api/versions/ce058568b9f0/schema)