创建群

本接口适用于企业需要根据群模板快速创建群聊的场景，如项目协作、活动组织等。具体如下图：

权限

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

基本信息

请求方式：POST

请求地址：https://oapi.dingtalk.com/topapi/im/chat/scenegroup/create

Query参数

Body参数

返回参数

示例

请求示例（HTTP）

POST https://oapi.dingtalk.com/topapi/im/chat/scenegroup/create?access_token=ACCESS_TOKEN

请求正文

{
        "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
}

请求示例（JAVA SDK，接口使用旧版服务端SDK，参见服务端SDK）

DingTalkClient client = new DefaultDingTalkClient("https://oapi.dingtalk.com/topapi/im/chat/scenegroup/create");
OapiImChatScenegroupCreateRequest req = new OapiImChatScenegroupCreateRequest();
req.setTitle("测试群");
req.setTemplateId("c354***-***-***-b4ea-6f1ab***65");
req.setOwnerUserId("022*****");
req.setUserIds("072*****,013*****");
req.setSubadminIds("072*****,013*****");
req.setUuid("axcf*-*****-*****-23da*");
req.setIcon("@lADOADma*****QKA");
req.setMentionAllAuthority(0L);
req.setShowHistoryType(0L);
req.setValidationType(0L);
req.setSearchable(0L);
req.setChatBannedType(0L);
req.setManagementType(0L);
req.setOnlyAdminCanDing(0L);
req.setAllMembersCanCreateMcsConf(1L);
req.setAllMembersCanCreateCalendar(0L);
req.setGroupEmailDisabled(0L);
req.setOnlyAdminCanSetMsgTop(0L);
req.setAddFriendForbidden(0L);
req.setGroupLiveSwitch(1L);
req.setMembersToAdminChat(0L);
OapiImChatScenegroupCreateResponse rsp = client.execute(req, access_token);
System.out.println(rsp.getBody());

返回示例

{
        "result":{
                "open_conversation_id":"cidt*****Xa4K10w==",
                "chat_id":"chat6d99a92e8x***"
        },
        "errcode":0,
        "success":true,
        "errmsg":"ok",
        "request_id": "ed669urokuvq"
}

错误码