创建群

接口调用量说明钉钉标准版接口累计可调用次数为1万次/月，当前接口会消耗调用次数。若该调用量无法满足需求，你可升级钉钉专业版(Open API调用量50万次/月)或钉钉专属版(Open API调用量500万次/月)扩容调用次数。

调用本接口根据群模板ID创建群。

调用本接口，可以根据群模板ID创建群，具体示例如下图所示。

重要

调用本接口前，确保你已经获得了群模板ID。

企业内部应用，详情参见基础概念。

第三方企业应用，详情参见基础概念。

创建群后，需要监听模板启用事件（chat_template_change），收到事件后群模板才安装完成，才可以发送消息。

企业内部应用，详情参见群变更事件。

第三方企业应用，详情参见群变更事件。

群的数量没有限制要求。

群中的人数上限为1000。

第三方企业应用调用本接口前，需要为群模板设置灰度企业。

权限

服务端API是以应用维度授权的，在调用接口前，确保已经为应用添加了接口权限。

应用类型	是否支持调用	权限申请方式	API Explorer调试
企业内部应用	支持	chat相关接口的管理权限	API Explorer
第三方企业应用	支持	chat相关接口的管理权限	API Explorer
第三方个人应用	暂不支持	chat相关接口的管理权限	暂不支持

错误码

错误码（errorcode）	错误码描述（errmsg）	解决方案
40035	参数错误	根据接口要求，传入必要参数。
665033	群成员数量超出限制	请减少群成员数量
665036	群模板不存在	请确认群模板id是否正确
660047	企业未在模板灰度名单内	请向模板所有者申请权限
660045	应用没有安装到目标企业	请在企业中安装应用
660046	企业内部应用模板，不能在其他企业使用	请在企业内部使用此模板
660036	权限校验失败	没有权限使用此模板
660041	不存在的员工	请确认群主的userid是否正确
400001	系统错误	请重试，若始终失败请提交工单
-1	系统繁忙	请稍后再试

curl --location --request POST 'https://oapi.dingtalk.com/topapi/im/chat/scenegroup/create?access_token' \ --header 'Content-Type: application/json' \ --data-raw '{ "title":"测试群", "template_id":"c354***-***-***-b4ea-6f1ab***65", "owner_user_id":"022*****", "user_ids":"072*****,013*****", "subadmin_ids":"072*****,013*****", "uuid":"axcf*-*****-*****-23da*", "icon":"@lADOADma*****QKA", "mention_all_authority":0, "show_history_type":0, "validation_type":0, "searchable":0, "chat_banned_type":0, "management_type":0, "only_admin_can_ding":0, "all_members_can_create_mcs_conf":1, "all_members_can_create_calendar":0, "group_email_disabled":0, "only_admin_can_set_msg_top":0, "add_friend_forbidden":0, "group_live_switch":1, "members_to_admin_chat":0 }'

权限

错误码

请求参数

返回响应

创建群

权限#

错误码#

请求参数

返回响应

权限

错误码