---
title: "Criar grupo WhatsApp"
method: POST
path: "/v1/groups"
tags: ["Groups"]
---

# Criar grupo WhatsApp

`POST /v1/groups`

Cria um grupo no WhatsApp com o nome e participantes fornecidos.

## Query parameters

- `connection` string, required

## Request body

- CreateGroupDto
  - `name` string, required
  - `participants` string[], required — Números só com dígitos (DDI + DDD + número, com ou sem +). O sufixo @s.whatsapp.net é aplicado automaticamente.

## Response `201`

Grupo criado; retorna `id` (PK em `Chat`)

- unknown

## Other responses

- `400` — Conexão inválida ou fechada
- `401` — Não autorizado
- `502` — Não foi possível concluir a operação no provedor de mensagens

---

[API](https://skmtc.dev/liderhub/apis/api-liderhub.md) · [All operations](https://skmtc.dev/liderhub/apis/api-liderhub/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/liderhub/api-liderhub/revisions/cce9b43211ac/schema)