Criar grupo

Cria um novo grupo e adiciona os participantes informados.

Endpoint

POST /groups/create

Parâmetros

Nome	Tipo	Obrigatório	Descrição
name	string	Sim	Nome do grupo
participants	string[]	Sim	Números dos participantes (formato internacional)

Request

cURL

curl -X POST https://endpoint.wi.api.br/groups/create \
  -H "x-api-key: $WIAPI_KEY" \
  -H "x-instance: session_01" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Projeto Alpha",
    "participants": ["5511999999999", "5511888888888"]
  }'

JavaScript

const response = await fetch("https://endpoint.wi.api.br/groups/create", {
  method: "POST",
  headers: {
    "x-api-key": process.env.WIAPI_KEY,
    "x-instance": "session_01",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    name: "Projeto Alpha",
    participants: ["5511999999999", "5511888888888"],
  }),
});

const group = await response.json();

Python

import requests

response = requests.post(
    "https://endpoint.wi.api.br/groups/create",
    headers={
        "x-api-key": WIAPI_KEY,
        "x-instance": "session_01",
    },
    json={
        "name": "Projeto Alpha",
        "participants": ["5511999999999", "5511888888888"],
    },
)

group = response.json()

Response

{
  "id": "120363045678901234@g.us",
  "name": "Projeto Alpha"
}