Create Device Group

Create a Device Group:
POST /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.


See also:
Get a List of Device Groups
Get Information about a Device Group
Update a Device Group
Delete a Device Group
Change Device Custom Fields

Request Components

HTTP Request


Resource and Query Parameters


Header Parameters

The request header must contain the current session token.

Parameter Name Data Type Description
string A valid session token returned by POST /session/login.

Request Body

The information about the device group that you want to create.

Parameter Name Data Type Description
string The Verizon billing account that the device group will belong to. An account name is usually numeric, and must include any leading zeros.
string The name for the new device group. This name must be unique within the specified account.
string A description for the device group.
array of deviceId objects 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.

required for devicesToAdd
string The type and value of the device identifier.
  • ESN - decimal, 11 digits
  • ICCID - decimal, up to 20 digits
  • IMEI - decimal, up to 15 digits
  • MDN - decimal, 10 digits
  • MEID - hexadecimal, 14 characters
  • MSISDN - decimal, 11 digits

Example Request Body

  "accountName": "10001234-0001",
  "groupName": "NV tanks",
  "groupDescription": "Nevada tank level monitors",
  "devicesToAdd": [
    {"kind": "imei", "identifier", "990003420535537"},
    {"kind": "imei", "identifier", "990005373420535"},
    {"kind": "imei", "identifier", "990003420537355"}

Success Responses

Status 200

Parameter Name Data Type Description
success Boolean A value of “true” indicates that the device group was created successfully.

Example Success Response

  "success": true

Failure Responses

Status 400

All error messages are returned in this format:

  "errorCode": "error code string",
  "errorMessage": "error message string"

Error codes and messages are listed on the Error Messages page, along with explanations and suggestions for corrective actions.

Try It Out!