> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zapclass.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar Grupo

> Criar um novo grupo no WhatsApp com participantes iniciais

Cria um novo grupo no WhatsApp adicionando participantes iniciais e configurando as informações básicas do grupo.

## Detalhes de Criação

> **Processo de Criação**
>
> O grupo é criado com você como administrador e os participantes iniciais.
>
> **Etapas:**
>
> 1. Validação dos participantes fornecidos
> 2. Criação do grupo no WhatsApp
> 3. Adição automática dos participantes
> 4. Configuração de permissões iniciais
> 5. Retorno das informações do grupo
>
> **Importante:** Você será automaticamente definido como administrador do grupo.

> **Requisitos de Participantes**
>
> Regras para adicionar participantes ao grupo.
>
> **Requisitos:**
>
> * Mínimo de 1 participante além do criador
> * Números devem estar no formato internacional
> * Apenas dígitos, sem símbolos ou formatação
> * Participantes devem ter WhatsApp ativo
> * Não podem estar bloqueando você
>
> **Formato:** `5511999999999` (código país + DDD + número)

> **Resposta Detalhada**
>
> A resposta inclui informações completas sobre o grupo criado.
>
> **Dados retornados:**
>
> * ID do grupo (JID)
> * Nome do grupo
> * Lista de participantes adicionados com sucesso
> * Lista de participantes que falharam (se houver)
> * Timestamp de criação
> * Status de cada operação
>
> Permite identificar problemas na adição de participantes.

> **Limitações e Comportamento**
>
> Restrições aplicadas durante a criação.
>
> **Limitações:**
>
> * Mínimo: 1 participante além do criador
> * Máximo: 1024 participantes (limite do WhatsApp)
> * Nome do grupo: máximo 25 caracteres
> * Participantes inválidos não impedem a criação
>
> **Comportamento:** Grupo é criado mesmo se alguns participantes falharem.

### Authorization

**api\_key** `string` *required*

Chave de autenticação da sua conexão, utilizada no header Authorization como
**Bearer** Token. \\

Você encontra sua API Key no botão **API** da sua conexão no painel ZapClass. \\

A chave sempre começa com o prefixo `zc_`. \\

Exemplo: `zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP`

### Body Parameters

**name** `string` *required*

Nome do grupo. \\

Máximo de 25 caracteres. \\

Exemplo: `"Equipe de Vendas 2024"`

**participants** `array` *required*

Lista de números de telefone dos participantes iniciais. \\

Formato internacional, apenas dígitos. \\

Mínimo de 1 participante. \\

Exemplo: `["5511999999999", "5511888888888"]`

> [!TIP]
>
> **Dica:** Mesmo que alguns participantes falhem ao serem adicionados, o grupo
> será criado. Verifique a resposta para identificar quais participantes foram
> adicionados com sucesso.

```bash cURL theme={null}
curl -X POST https://zapclass.com.br/api/groups/create \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP" \
  -d '{
    "name": "Equipe de Vendas",
    "participants": ["5511999999999", "5511888888888"]
  }'
```

```javascript JavaScript theme={null}
const response = await fetch("https://zapclass.com.br/api/groups/create", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP",
  },
  body: JSON.stringify({
    name: "Equipe de Vendas",
    participants: ["5511999999999", "5511888888888"],
  }),
});

const data = await response.json();
if (data.success) {
  console.log("Grupo criado:", data.group.name);
  console.log("ID do grupo:", data.group.id);
  console.log("Participantes adicionados:", data.participants.success.length);
}
```

```php PHP theme={null}
<?php
$ch = curl_init('https://zapclass.com.br/api/groups/create');

$payload = [
    "name" => "Equipe de Vendas",
    "participants" => ["5511999999999", "5511888888888"]
];

curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer zc_6FrX2qjM4bHT9pR6cC0sD8wLkG3nE2tZfV5uN1aP'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$data = json_decode($response, true);

if ($data['success']) {
    echo "Grupo criado: {$data['group']['name']}\n";
    echo "ID: {$data['group']['id']}\n";
    echo "Participantes adicionados: " . count($data['participants']['success']);
} else {
    echo "Erro: " . $data['message'];
}
curl_close($ch);
?>
```

```json 200 theme={null}
{
  "success": true,
  "message": "Group created successfully",
  "group": {
    "id": "120363123456789012@g.us",
    "name": "Equipe de Vendas",
    "timestamp": 1672531200000,
    "creator": "5511999999999@s.whatsapp.net"
  },
  "participants": {
    "success": ["5511999999999@s.whatsapp.net", "5511888888888@s.whatsapp.net"],
    "failed": []
  }
}
```

```json 400 theme={null}
{
  "success": false,
  "message": "Nome do grupo é obrigatório"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.