API Description

Creates a device group. Each account can only has 1,000 groups.

API Request Format

HTTP request method: POST (use the HTTPS protocol)https://api.weixin.qq.com/shakearound/device/group/add?access_token=ACCESS_TOKEN
POST data format: json
POST data example:


Parameter Required Description
access_token Yes The credential for calling the API
group_name Yes Group name, with a maximum length of 100 Chinese characters (200 English characters)


Example of JSON packet returned for a successful request:

  "data": {
      "group_id" : 123,
      "group_name" : "test"
  "errcode": 0,
  "errmsg": "success."


Parameter Description
group_id The globally unique identifier of the group
group_name Group name