H P L Device Management

Adds up to 200 new devices, without provisioning lines of service for them.

POST
/hyper-precise/v1/devices/actions/add

Use this API if you want to manage some device settings before you are ready to activate service for the devices.

Authorization

thingspace_oauth VZ-M2M-Token
AuthorizationBearer <token>

This is the ThingSpace token, from Credentials and Tokens is used

In: header

VZ-M2M-Token<token>

M2M Session Token (How to generate an M2M session token?)

In: header

Request Body

application/json

Devices to add to the account.

Devices to add to the account.

state?string

The initial service state for the devices. The only valid state is "Preactive."

devicesToAdd?array<>

The devices that you want to add.

accountName?string

The numeric name of the account and must include leading zeroes.

customFields?array<>

The names and values for any custom fields that you want set for the devices as they are added to the account.

groupName?string

The name of a device group to add the devices to. They are added to the default device group if you don't include this parameter.

skuNumber?string

The Stock Keeping Unit (SKU) number of a 4G device type with an embedded SIM.

smsrOid?string

The Subscription Manager Secure Router Object ID, used for remote SIM provisioning. SMSR securely routes the download and management of eSIM profiles.

numberOfVirtualImei?integer

numberOfVirtualImei.

Formatint32
uploadType?string

uploadType.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/hyper-precise/v1/devices/actions/add" \  -H "Content-Type: application/json" \  -d '{    "accountName": "0000123456-00001",    "customFields": [      {        "key": "CustomField2",        "value": "SuperVend"      }    ],    "devicesToAdd": [      {        "deviceIds": [          {            "kind": "imei",            "id": "15-digit IMEI"          },          {            "kind": "iccid",            "id": "20-digit ICCID"          }        ]      },      {        "deviceIds": [          {            "kind": "imei",            "id": "15-digit IMEI"          },          {            "kind": "iccid",            "id": "20-digit ICCID"          }        ]      }    ],    "groupName": "West Region",    "state": "preactive"  }'
[  {    "deviceIds": [      {        "id": "20-digit ICCID",        "kind": "iccid"      }    ],    "response": "Success"  }]