Use this API if you want to manage some device settings before you are ready to activate service for the devices.
thingspace_oauth VZ-M2M-Token In: header
M2M Session Token (How to generate an M2M session token?)
In: header
application/json
Devices to add.
TypeScript Definitions
Use the request body type in TypeScript.
Request to add the devices.
application/json
application/json
curl -X POST "https://example.com/m2m/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": "Pre-active" }'[ { "deviceIds": [ { "id": "20-digit ICCID", "kind": "iccid" } ], "response": "Success" }]{ "errorCode": "error code string", "errorMessage": "error message string"}The initial service state for the devices. The only valid state is “Pre-active.”
The devices that you want to add.
The billing account to which the devices are added.
The names and values for any custom fields that you want set for the devices as they are added to the account.
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.
The Stock Keeping Unit (SKU) number of a 4G device type with an embedded SIM.
^[A-Za-z0-9]{3,32}$3 <= length <= 32