# Criar um novo grupo

`POST /group/create`

Pasta: **Grupos e Comunidades**

## Autenticação

```http
token: {{token}}
```

## Descrição

# Criar um novo grupo

Cria um grupo no WhatsApp e adiciona os participantes informados. Use quando precisar abrir um grupo novo pela API (atendimento, equipe, campanha).

## Endpoint

`POST {{baseUrl}}/group/create`

## Autenticação

Envie o token da instância no header:

`token: {{token}}`

## Corpo da requisição

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| name | string | Sim | Nome do grupo |
| participants | array de string | Sim | Números dos participantes iniciais (somente dígitos, com DDI) |
| isCommunity | boolean | Não | Se `true`, cria como comunidade (prefira `/community/create`) |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/group/create" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Meu Novo Grupo",
  "participants": [
    "5521987905995"
  ]
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "group": {
    "JID": "120363123456789012@g.us",
    "OwnerJID": "5511999999999@s.whatsapp.net",
    "Name": "Meu Novo Grupo",
    "GroupCreated": "2026-07-17T12:00:00Z",
    "ParticipantVersionID": "1234567890",
    "Participants": [
      {"JID": "5511999999999@s.whatsapp.net", "IsAdmin": true, "IsSuperAdmin": true},
      {"JID": "5521987905995@s.whatsapp.net", "IsAdmin": false, "IsSuperAdmin": false}
    ]
  }
}
```

## Erros comuns

- Instância desconectada ou token inválido (401).
- Participante sem WhatsApp ou número mal formatado.
- WhatsApp pode limitar quantos membros dá para adicionar de uma vez.

## Observações

- O criador do grupo é a conta da instância autenticada.
- Números sem `+`, espaços ou pontuação — ex.: `5521987905995`.

## Corpo (exemplo)

```json
{
  "name": "Meu Novo Grupo",
  "participants": [
    "5521987905995"
  ]
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/group/create" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Meu Novo Grupo",
  "participants": [
    "5521987905995"
  ]
}'
```

---

[Índice da pasta](./index.md) · [Índice geral](../index.md) · [UI](https://gozap.dev/docs?op=grupos-e-comunidades/criar-um-novo-grupo)