Criar grupo

Cria um grupo e adiciona os participantes informados. Exige a instância conectada. A resposta já traz o link de convite (best-effort).

POSThttps://api.zapdev.com.br/v1/groups

Parâmetros do corpo

Campo	Tipo	Descrição
`subject` (obrig.)	string	Nome do grupo (1–100 caracteres)
`description` (opc.)	string	Descrição do grupo (até 512 caracteres)
`participants` (obrig.)	string[]	1–50 números em E.164 (só dígitos)

Requisição

curl -X POST https://api.zapdev.com.br/v1/groups \
  -H "Authorization: Bearer zd_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "subject": "Evento ZapDev 2026",
    "description": "Grupo oficial dos inscritos.",
    "participants": ["5511999999999"]
  }'

{
  "data": {
    "groupId": "1203...@g.us",
    "subject": "Evento ZapDev 2026",
    "inviteUrl": "https://chat.whatsapp.com/..."
  }
}

Erros

HTTP	`error.code`	Quando
422	`instance_not_connected`	instância sem WhatsApp conectado
400	`invalid_request`	`subject` fora de 1–100 ou participantes inválidos