Create a device

Create a device

post

Query parameters

api-versionstringOptional

Header parameters

BrandUrlstringRequired

The brand URL of the request. This is used to identify the brand.

Example: YOUR_BRAND_URL

AuthkeystringRequired

This is used to authenticate the request. If the request is not authenticated, the server will return a 401 Unauthorized response.

Example: YOUR_AUTH_KEY

Body

application/jsontext/jsonapplication/*+json

This class provides the Device Command Request Dto.

typeinteger · int32 | nullableOptional

The type of the device.

codestring · min: 1Required

The code of the device.

isMobileAppbooleanOptional

Flag indicating if the device is a mobile app. By default, it is false.

tagsstring | nullableOptional

The tags of the device.

statusstring · enumOptionalPossible values:

isDefaultboolean | nullableOptional

Flag indicating if the device is the default device.

testModeboolean | nullableOptional

The test mode of the device.

namestring · min: 1Required

The name of the device.

phoneNumberstring | nullableOptional

The phone number of the device.

osDevicestring · min: 1Required

The operating system of the device.

appVersionNumberstring · min: 1Required

The version of the operating system of the device.

iccidstring | nullableOptional

The iccid of the device.

imsistring | nullableOptional

The imsi of the device.

imeistring | nullableOptional

The imei of the device.

simCardInfostring | nullableOptional

The sim card info of the device.

Responses

201

The request was successful.

application/json

401

The user is not authorized to access the requested resource. The request is missing the required AuthKey header.

application/json

429

The user has exceeded the rate limit.

application/json

post

HTTPcURLJavaScriptPython

POST /api/devices HTTP/1.1
Host: protocol.jframework.dev
BrandUrl: text
Authkey: text
Content-Type: application/json
Accept: */*
Content-Length: 257

{
  "type": 1,
  "code": "text",
  "isMobileApp": true,
  "tags": "text",
  "status": "0 - Inactive",
  "isDefault": true,
  "testMode": true,
  "name": "text",
  "phoneNumber": "text",
  "osDevice": "text",
  "appVersionNumber": "text",
  "iccid": "text",
  "imsi": "text",
  "imei": "text",
  "simCardInfo": "text"
}

application/jsontext/jsonapplication/*+json

{
  "success": true,
  "statusCode": 201,
  "message": "The request was successful.",
  "data": {
    "type": 1,
    "code": "XYZ123",
    "isMobileApp": true,
    "tags": "android, smartphone",
    "status": "Active",
    "isDefault": true,
    "testMode": false,
    "name": "John's Phone",
    "phoneNumber": "[phone]",
    "osDevice": "Android",
    "appVersionNumber": "1.0.5",
    "iccid": "89148000000000000001",
    "imsi": "310260000000000",
    "imei": "356938035643809",
    "simCardInfo": "Verizon SIM",
    "modifiedDate": "2025-05-08T13:15:31.8323959Z",
    "id": "sApKpllz4sAplsmzha"
  },
  "errors": []
}