# Criar uma comunidade

`POST /community/create`

Pasta: **Grupos e Comunidades**

## Autenticação

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

## Descrição

# Criar uma comunidade

Cria uma comunidade no WhatsApp (mesmo handler de criação de grupo, com `isCommunity: true`). O WhatsApp gera a estrutura de comunidade/grupo pai.

## Endpoint

`POST {{baseUrl}}/community/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 da comunidade |
| participants | array de string | Não | Participantes iniciais (números com DDI) |
| isCommunity | boolean | Sim | Deve ser `true` para criar comunidade |

## Exemplo de Requisição

```bash
curl -X POST "{{baseUrl}}/community/create" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Comunidade do Bairro",
  "participants": [
    "5511999999999"
  ],
  "isCommunity": true
}'
```

## Resposta de Sucesso

```json
{
  "success": true,
  "group": {
    "JID": "120363456789012345@g.us",
    "Name": "Comunidade do Bairro",
    "IsParent": true,
    "OwnerJID": "5511999999999@s.whatsapp.net",
    "Participants": [
      {"JID": "5511999999999@s.whatsapp.net", "IsAdmin": true, "IsSuperAdmin": true}
    ]
  }
}
```

## Erros comuns

- `isCommunity` deve ser `true`.
- Conta sem suporte a comunidades.
- Instância desconectada ou token inválido.

## Observações

- Depois vincule grupos com `/community/editgroups`.
- Liste subgrupos com `/community/subgroups`.

## Corpo (exemplo)

```json
{
  "name": "Comunidade do Bairro",
  "participants": [
    "5511999999999"
  ],
  "isCommunity": true
}
```

## cURL

```bash
curl -X POST "{{baseUrl}}/community/create" \
  -H "token: {{token}}" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Comunidade do Bairro",
  "participants": [
    "5511999999999"
  ],
  "isCommunity": true
}'
```

---

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