You need to enable JavaScript to run this app.
Cloud Monitor

Cloud Monitor

Copy page
Download PDF
Alert contact groups
CreateContactGroup
Copy page
Download PDF
CreateContactGroup
Create an alert contact group.​
Limits​
A single account can create at most 100 contact groups.​
Request descriptions​
  • Request method: POST​
  • Request URL: https://cloudmonitor.cn-beijing.volcengineapi.com?Action=CreateContactGroup&Version=2018-01-01​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
​
Paramete​
Types​
Required​
Sample value​
Description​
Action​
String​
Yes​
CreateContactGroup​
The name of the API. The API name is CreateContactGroup.​
Version​
String​
Yes​
2018-01-01​
The API version. The API version is 2018-01-01.​
Name​
String​
Yes​
primary_contact_group​
Contact group name.​
  • It cannot start with a digit or hyphen.​
  • It can contain only Chinese characters, letters, digits, underscores (_), and hyphens (-).​
  • The name must be 1 to 128 characters in length.​
Description​
String​
No​
This contact group is the primary contact group. Use this contact group if you do not need a particular contact group.​
Contact group description.​
  • If no value is provided, it defaults to an empty string.​
  • It must be 1 to 255 characters in length.​
  • It can contain Chinese characters, letters, and special characters such as underscores.​
ContactsIdList​
Array of String​
No​
["145247681036000****",​
"145247681036001****"]​
Contacts to be added to the contact group. The value is a list of contact IDs.​
  • The number of contact IDs cannot exceed 10, since a single contact group can contain up to 10 contacts.​
​
Sample request​
​
POST https://cloudmonitor.cn-beijing.volcengineapi.com?Action=CreateContactGroup&Version=2018-01-01​
Content-Type: application/json​
{​
"Description": "This contact group is the primary contact group. Please bind this contact group by default.",​
"Name": "primary_contact_group",​
"ContactsIdList": [​
"145247681036000****",​
"145247681036001****"​
]​
}​
​
Response parameters​
​
Parameters​
Type​
Sample value​
Description​
Data​
Array of String​
["1599*****9648"]​
Contact group ID.​
​
Sample response​
​
{​
"ResponseMetadata": {​
"Action": "CreateContactGroup",​
"Region": "cn-beijing",​
"Service": "cloudmonitor",​
"Version": "2018-01-01",​
"RequestId": "20230604110420****100232280022D31"​
},​
"Result": {​
"Data": [​
"1599*****9648"​
]​
}​
}​
​
Error codes​
There are no error codes specific to this API. For more information, see Error codes.​
​
​
Last updated: 2026.07.10 14:02:24