docs-web-logo
开发文档

创建用户组

调用该接口创建新的用户组，可以设置用户组的名称、描述和自定义ID等信息。

注意事项

  • 用户组名称长度不能超过40个字符
  • 描述长度不能超过256个字符
  • AliasId长度不能超过64个字符

请求

基本
请求方式POST
请求地址/openapi/v3/contacts/groups

请求头

名称类型必填描述
Authorizationstring是值格式：Bearer {{access_token}}

调用 API 时，需要通过访问凭证（access_token）进行身份鉴权，不同类型的访问凭证可获取的数据范围不同，参考 获取访问凭证 。

支持鉴权类型：
• 应用级token：以应用身份调用 API，校验应用的数据访问范围。参考 获取企业内部应用access_token。
• 用户级token：以登录用户身份调用 API，校验用户的可见数据范围。参考 获取登录用户access_token。
Content-Typestring是固定值：application/json; charset=utf-8

请求体

名称类型必填描述
namestring是名字，长度不超过40个字符
descriptionstring否描述，长度不超过256个字符
alias_idstring否AliasId，长度不超过64个字符

请求体示例

  1{
  2  "name": "技术研发组",
  3  "description": "负责公司技术研发工作",
  4  "alias_id": "tech_dev_group"
  5}

响应

响应体

  1{
  2  "code": 0,
  3  "msg": "success",
  4  "data": {
  5    "group_id": ""
  6  }
  7}