Add Device to Account

Adds a device to the current account. Provide the device ID and password to confirm that you can add the device. This endpoint requires device:manage.

Endpoint

POST /wlte/v1/devices

Authorization Requirements

Scope	Required	Description
device:manage	Yes	Add a device to the current account

Request Body

Field	Type	Required	Description
deviceId	string	Yes	Device ID to associate
password	string	Yes	Device password. Must be 4 characters
name	string	No	Display name, up to 16 characters. If omitted or blank, deviceId is used

Request Example

{
  "deviceId": "rek053537488",
  "password": "1234",
  "name": "Office Gateway"
}

curl example:

curl --request POST '{baseUrl}/wlte/v1/devices' \
  --header 'Authorization: Bearer {accessToken}' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json' \
  --data '{
    "deviceId": "rek053537488",
    "password": "1234",
    "name": "Office Gateway"
  }'

Success Response

{
  "code": "SUCCESS",
  "message": "OK.",
  "requestId": "7d2e2e30-36d7-4e31-9e89-c840f54185f8",
  "data": {
    "deviceId": "rek053537488",
    "name": "Office Gateway"
  }
}

Common Errors

HTTP Status	code	Description
400	INVALID_REQUEST	Missing deviceId, or password is not 4 characters
400	INVALID_DEVICE_PASSWORD	Device password is incorrect
401	AUTH_INVALID	Access token is invalid or no longer valid
403	AUTH_SCOPE_DENIED	The API Client does not have device:manage
409	DEVICE_OFFLINE	The device is offline, so the password cannot be verified
409	DEVICE_BUSY	The device already has an in-flight request. Try again later
429	RATE_LIMITED	Too many requests
503	GATEWAY_UNAVAILABLE	Device add service is temporarily unavailable
504	DEVICE_TIMEOUT	Timed out waiting for device confirmation