服务端 API/通讯录/用户组/创建用户组
# 创建用户组

使用该接口创建用户组，请注意创建用户组时应用的通讯录权限范围需为“全部员工”，否则会创建失败，[点击了解通讯录权限范围](https://open.larksuite.com/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)。

## 请求

基本 |  
---|---
HTTP URL | https://open.larksuite.com/open-apis/contact/v3/group
HTTP Method | POST
支持的应用类型 | Custom App
权限要求<br>**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 更新用户组信息(contact:group)

### 请求头

名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`<br>**值格式**："Bearer `access_token`"<br>**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"<br>[了解更多：获取与使用access_token](https://open.larksuite.com/document/ukTMukTMukTM/uMTNz4yM1MjLzUzM)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"

### 请求体

名称 | 类型 | 必填 | 描述
---|---|---|---
group_id | string | 否 | 自定义用户组ID，可在创建时自定义，不自定义则由系统自动生成，已创建用户组不允许修改 group_id 。<br>自定义group_id数据校验规则：<br>最大长度：64 字符<br>校验规则：数字、大小写字母的组合，不能包含空格<br>**示例值**："g122817"
name | string | 是 | 用户组的名字，企业内唯一，最大长度：100 字符<br>**示例值**："IT 外包组"
description | string | 否 | 用户组描述<br>**示例值**："IT服务人员的集合"
type | int | 否 | 用户组的类型。默认为1表示普通用户组<br>**示例值**：1<br>**可选值有**：<br>- 1：普通用户组<br>**默认值**：`1`

### 请求体示例
```json
{
    "group_id": "g122817",
    "name": "IT 外包组",
    "description": "IT服务人员的集合",
    "type": 1
}
```

## 响应

### 响应体

名称 | 类型 | 描述
---|---|---
code | int | 错误码，非 0 表示失败
msg | string | 错误描述
data | \- | \-
group_id | string | 用户组ID

### 响应体示例
```json
{
    "code": 0,
    "msg": "success",
    "data": {
        "group_id": "g122817"
    }
}
```

### 错误码

HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
500 | 40003 | internal error | 内部错误，请提供 X-Request-Id向客服反馈。[联系客服](https://applink.larksuite.com/client/helpdesk/open?id=6626260912531570952&extra=%7B%22channel%22%3A14%2C%22created_at%22%3A1614493146%2C%22scenario_id%22%3A6885151765134622721%2C%22signature%22%3A%22ca94c408b966dc1de2083e5bbcd418294c146e98%22%7D)。
400 | 42002 | invalid group_id | 用户组 ID 无效
400 | 42003 | group type invalid | 用户组类型无效
400 | 42001 | group name empty | 用户组名字不得为空
400 | 42013 | group name exceed limit | 用户组名字长度超过最大限制，最大限制100字符
400 | 42014 | group description exceed limit | 用户组描述长度超过最大限制，最大限制500字符
403 | 42010 | not has all authority error | 应用通讯录权限范围需为全部员工，[点击了解通讯录权限范围](https://open.larksuite.com/document/ukTMukTMukTM/uETNz4SM1MjLxUzM/v3/guides/scope_authority)
400 | 47005 | duplicate group id error | 用户组自定义 ID 重复，企业内唯一
400 | 47009 | duplicated name error | 用户组名称不得在企业内重复
400 | 42016 | user group number exceed limit | 用户组数量超过最大限制，单个企业最多可创建500个用户组
400 | 42015 | user group disable | 用户组功能未开启，请联系Lark客服处理，[联系客服](https://applink.larksuite.com/client/helpdesk/open?id=6626260912531570952&extra=%7B%22channel%22%3A14%2C%22created_at%22%3A1614493146%2C%22scenario_id%22%3A6885151765134622721%2C%22signature%22%3A%22ca94c408b966dc1de2083e5bbcd418294c146e98%22%7D)