---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/nhom-chat-gmf/quan-ly/create_group
title: Tạo nhóm mới
---
# Tạo nhóm mới


:::warning Lưu ý
Ứng dụng cần được cấp quyền quản lý thông tin nhóm.
:::


## Luồng tạo nhóm
![](/assets/OA/img/createGroup.jpg)

Giải thích:
- (1) Gửi request [Lấy hạn mức nhóm của OA](/docs/OA/nhom-chat-gmf/quan-ly/quota)
- (2) Hệ thống Zalo trả về danh sách các gói kèm asset_id
- (3) Gửi request tạo nhóm chat kèm theo asset_id
- (3) Hệ thống Zalo trả về thông tin nhóm chat được tạo thành công

## HTTP request

- **URL:** [https://openapi.zalo.me/v3.0/oa/group/creategroupwithoa](//openapi.zalo.me/v3.0/oa/group/creategroupwithoa)
- **Method:** POST
- **Content Type:** application/json
- **Response Type:** application/json

## Example request

```bash
curl --request POST 'https://openapi.zalo.me/v3.0/oa/group/creategroupwithoa' \
--header 'access_token: <your_oa_access_token>' \
--header 'Content-Type: application/json' \
--data '{
    "group_name": "Tư vấn nha khoa",
    "group_description": "Group tư vấn nha khoa cho các nhân viên",
    "asset_id": "326e977e4d3da463fd2c",
    "member_user_ids": [
        "186729651760683225"
    ]
}'
```

### Tham số header

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token[tại đây](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new). |


### Cấu trúc body của request

| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| group_name | string | yes | Tên nhóm |
| group_description | string | optional | Mô tả nhóm |
| asset_id | string | yes | ID gói GMF, sử dụng để làm dịch vụ hoạt động của Nhóm. (Lấy ID bằng cách gọi API [Lấy hạn mức tạo nhóm GMF](/docs/OA/nhom-chat-gmf/quan-ly/quota)) |
| member_user_ids | array | yes | Danh sách các user trong nhóm (danh sách này không được để trống và không quá 99 người và có ít nhất 1 người là admin của OA) |


## Example respond

```json
{
    "data": {
        "name": "Group name",
        "avatar": "http://s120.ava.grp.talk.zdn.vn/default",
        "group_id": "8fba1979fa25137b4a",
        "group_link": "https://zalo.me/g/qsbexj32",
        "group_description": "",
        "total_member": 2,
        "status": "enabled"
    },
    "error": 0,
    "message": "Success"
}
```

### Cấu trúc thuộc tính data

| Tham số | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| name | string | Tên nhóm |
| avatar | string | Avatar của nhóm |
| group_id | string | ID của nhóm |
| group_link | string | Link để tham gia nhóm |
| group_description | string | Mô tả nhóm |
| total_member | string | Tổng số lượng thành viên trong nhóm |
| status | string | Trạng thái nhóm - enabled: OA có thể quản lý và gửi tin nhắn trong nhóm - disabled: OA không thể quản lý và không thể gửi tin nhắn trong nhóm |

####