Verizon 5G Edge API Portal
Verizon 5G EdgeThingSpace
HomeSDKsContext PluginAPI Reference
Device Management

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

POST
/m2m/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.

Devices to add.

state*string

The initial service state for the devices. The only valid state is “Pre-active.”

devicesToAdd*array<>

The devices that you want to add.

accountName?string

The billing account to which the devices are added.

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
Match^[A-Za-z0-9]{3,32}$
Length3 <= length <= 32

Response Body

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"  }]

Activates service for one or more devices. POST

If the devices do not already exist in the account, this API resource adds them before activation.

Changes the name and address associated with a device. PUT

Sends a CarrierService callback message for each device in the request when the contact information has been changed, or if there was a problem and the change could not be completed.