- 应用权限
- API 调用指南
- 事件与回调
- 服务端 SDK
- 认证及授权
- 通讯录
- 事件管理
- 消息
- 群组
- 云文档
- 日历
- 视频会议
- 考勤打卡
- 审批
- 服务台
- 任务
- 邮箱
- 应用信息
- 企业信息
- 认证信息
- 个人设置
- 搜索
- AI 能力
- 管理后台
- 飞书人事（标准版）
- 飞书人事（企业版）
- 招聘
- OKR
- 实名认证
- 智能门禁
- 企 业百科
- 妙记
- 工作台
- 企业
创建用户组
POST
/contact/v3/group
错误码#
| HTTP状态码 | 错误码 | 描述 | 排查建议 |
|---|---|---|---|
| 500 | 40003 | internal error | 内部错误，请提供 X-Request-Id向客服反馈。联系客服。 |
| 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 | 应用通讯录权限范围需为全部员工，点击了解通讯录权限范围 |
| 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 | 用户组功能未开启，请联系飞书客服处理，联系客服 |
请求参数
Authorization
Bearer Token
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************or
Body 参数application/json
示例
返回响应
🟢200成功
application/json
Body
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/contact/v3/group' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"group_id": "g122817",
"name": "IT 外包组",
"description": "IT服务人员的集合",
"type": 1
}'响应示例响应示例
{
"code": 0,
"msg": "success",
"data": {
"group_id": "g122817"
}
}
【飞书】API开发者 微信交流群
用微信扫右侧二维码，加入【飞书】API开发者 交流群，互助沟通
扫码加入交流群修改于 2025-10-20 09:19:59