Device Groups

Creates a new device group and optionally adds a set of devices to that group.

POST
/m2m/v1/groups

Create a new device group and optionally add devices to the group. Device groups can make it easier to manage similar devices and to get reports on their usage.

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

A request to create a new device group.

A request to create a new device group.

accountName*string

The Verizon billing account that the device group will belong to. An account name is usually numeric, and must include any leading zeros.

groupDescription*string

A description for the device group.

groupName*string

The name for the new device group. This name must be unique within the specified account.

devicesToAdd?array<>

Zero or more devices to add to the device group. You can use POST /devices/actions/list to get a list of all devices in the account.

Response Body

application/json

application/json

curl -X POST "https://example.com/m2m/v1/groups" \  -H "Content-Type: application/json" \  -d '{    "accountName": "0000123456-00001",    "groupName": "group name",    "groupDescription": "descriptive string",    "devicesToAdd": [      {        "kind": "imei",        "id": "15-digit IMEI"      }    ]  }'
{  "success": true}