创建群组

POST

/im/group/createGroup

创建群组

Request

Header Params

Body Params application/jsonRequired

Example

{
    "actionStatus": "string",
    "appDefinedDataList": [
        {
            "Key": "GroupTestData1",
            "Value": "xxxxx"
        }
    ],
    "applyJoinOption": "FreeAccess",
    "defaultPermission": 1,
    "enablePermission": 1,
    "errorCode": 0,
    "errorInfo": "string",
    "faceUrl": "http://this.is.face.url",
    "groupId": "string",
    "introduction": "This is group Introduction",
    "inviteJoinOption": "FreeAccess",
    "maxMemberCount": 500,
    "memberInfoList": [
        {
            "Member_Account": "bob",
            "Role": "Admin"
        }
    ],
    "name": "TestGroup",
    "notification": "This is group Notification",
    "ownerAccount": "leckie",
    "supportTopic": 1,
    "type": "Public"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/im/group/createGroup' \
--header 'x-access-token: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzeXNVaWQiOiJlOWNhMjNkNjhkODg0ZDRlYmIxOWQwNzg4OTcyN2RhZSIsInVzZXJJZGVudGl0eSI6MiwiZXhwIjoxNzQ3MDgxNzYzLCJ1c2VybmFtZSI6ImFkbWluIn0.NaeqryXHUXcM8u5j_l2cIjTyywLEiMHQklrPpEHy79k' \
--header 'Content-Type: application/json' \
--data-raw '{
    "actionStatus": "string",
    "appDefinedDataList": [
        {
            "Key": "GroupTestData1",
            "Value": "xxxxx"
        }
    ],
    "applyJoinOption": "FreeAccess",
    "defaultPermission": 1,
    "enablePermission": 1,
    "errorCode": 0,
    "errorInfo": "string",
    "faceUrl": "http://this.is.face.url",
    "groupId": "string",
    "introduction": "This is group Introduction",
    "inviteJoinOption": "FreeAccess",
    "maxMemberCount": 500,
    "memberInfoList": [
        {
            "Member_Account": "bob",
            "Role": "Admin"
        }
    ],
    "name": "TestGroup",
    "notification": "This is group Notification",
    "ownerAccount": "leckie",
    "supportTopic": 1,
    "type": "Public"
}'

Responses

🟢200OK

*/*

Body

Example

{
    "code": 0,
    "message": "string",
    "result": {
        "actionStatus": "string",
        "appDefinedDataList": [
            {
                "Key": "GroupTestData1",
                "Value": "xxxxx"
            }
        ],
        "applyJoinOption": "FreeAccess",
        "defaultPermission": 1,
        "enablePermission": 1,
        "errorCode": 0,
        "errorInfo": "string",
        "faceUrl": "http://this.is.face.url",
        "groupId": "string",
        "introduction": "This is group Introduction",
        "inviteJoinOption": "FreeAccess",
        "maxMemberCount": 500,
        "memberInfoList": [
            {
                "Member_Account": "bob",
                "Role": "Admin"
            }
        ],
        "name": "TestGroup",
        "notification": "This is group Notification",
        "ownerAccount": "leckie",
        "supportTopic": 1,
        "type": "Public"
    },
    "success": true,
    "timestamp": 0
}

🟢201Created

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

Modified at 2025-10-17 00:33:09

清空群聊历史消息

腾讯IM群组管理-解散群组