> For the complete documentation index, see [llms.txt](https://docs.zapfy.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zapfy.me/integrando-com-a-api/grupos/criar-um-novo-grupo.md).

# Criar um novo grupo

Permite criar um grupo no WhatsApp usando a Zapfy!

###

### Exemplo de body a ser enviado:

```
{
    "name": "Meu grupo sensacional :)",
    "participants": ["556195514650"]
}
```

## Criar um novo grupo no WhatsApp

<mark style="color:green;">`POST`</mark> `https://api.zapfy.me/v1/instance/{{instanceKey}}/token/{{instanceToken}}/createGroup`

#### Path Parameters

| Name                                            | Type   | Description                       |
| ----------------------------------------------- | ------ | --------------------------------- |
| instanceKey<mark style="color:red;">\*</mark>   | String | Key de identificação da instância |
| instanceToken<mark style="color:red;">\*</mark> | String | Token de acesso da instância      |

#### Request Body

| Name                                   | Type   | Description                                                         |
| -------------------------------------- | ------ | ------------------------------------------------------------------- |
| participants                           |        | Lista de números em string dos participantes que iniciarão no grupo |
| name<mark style="color:red;">\*</mark> | String | Nome do grupo                                                       |

{% tabs %}
{% tab title="200: OK Grupo criado com sucesso" %}

```javascript
{
    "result": {
        "id": "120363047212563241@g.us",
        "subject": "Meu grupo sensacional :)",
        "subjectOwner": "556195514650@s.whatsapp.net",
        "subjectTime": 1674331780,
        "size": null,
        "creation": 1674331780,
        "owner": "556195514650@s.whatsapp.net",
        "restrict": false,
        "announce": false,
        "participants": [
            {
                "id": "556195514650@s.whatsapp.net",
                "admin": "superadmin"
            },
            {
                "id": "5527997320619@s.whatsapp.net",
                "admin": null
            }
        ]
    },
    "isValid": true
}
```

{% endtab %}
{% endtabs %}