cURL
curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/groups \
--header 'Content-Type: application/json' \
--data '
{
"name": "Equipe Wabox",
"participants": [
"5511988887777",
"5511977776666"
]
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Equipe Wabox', participants: ['5511988887777', '5511977776666']})
};
fetch('https://api.wabox.me/instances/{instance_id}/token/{token}/groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wabox.me/instances/{instance_id}/token/{token}/groups"
payload = {
"name": "Equipe Wabox",
"participants": ["5511988887777", "5511977776666"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wabox.me/instances/{instance_id}/token/{token}/groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Equipe Wabox',
'participants' => [
'5511988887777',
'5511977776666'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wabox.me/instances/{instance_id}/token/{token}/groups"
payload := strings.NewReader("{\n \"name\": \"Equipe Wabox\",\n \"participants\": [\n \"5511988887777\",\n \"5511977776666\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "120363012345678901-group",
"name": "Equipe Wabox",
"description": "Grupo de testes",
"owner": "5511999998888",
"created_at": "2026-08-01T10:00:00.000Z",
"participants": [
{
"phone": "5511999998888",
"lid": "123456789012345@lid",
"is_admin": true,
"is_super_admin": true
},
{
"phone": "5511988887777",
"is_admin": false,
"is_super_admin": false
}
],
"participant_count": 2,
"announce": false,
"locked": false,
"join_approval_required": false,
"member_add_mode": "all_member_add",
"ephemeral_seconds": 0,
"is_community": false,
"suspended": false
}{
"error": {
"code": "instance_not_found",
"message": "Instance not found or invalid token"
}
}{
"error": {
"code": "subscription_required",
"message": "Trial expired or subscription inactive. Subscribe in the dashboard to keep sending."
}
}{
"error": {
"code": "instance_not_connected",
"message": "Instance is not connected"
}
}Criar grupo
Você é adicionado como super admin automaticamente. Participantes que não puderam ser adicionados aparecem na lista de participantes do grupo retornado. Imediata: exige a instância conectada (caso contrário, 409 instance_not_connected).
POST
/
instances
/
{instance_id}
/
token
/
{token}
/
groups
cURL
curl --request POST \
--url https://api.wabox.me/instances/{instance_id}/token/{token}/groups \
--header 'Content-Type: application/json' \
--data '
{
"name": "Equipe Wabox",
"participants": [
"5511988887777",
"5511977776666"
]
}
'const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({name: 'Equipe Wabox', participants: ['5511988887777', '5511977776666']})
};
fetch('https://api.wabox.me/instances/{instance_id}/token/{token}/groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.wabox.me/instances/{instance_id}/token/{token}/groups"
payload = {
"name": "Equipe Wabox",
"participants": ["5511988887777", "5511977776666"]
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.wabox.me/instances/{instance_id}/token/{token}/groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'name' => 'Equipe Wabox',
'participants' => [
'5511988887777',
'5511977776666'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.wabox.me/instances/{instance_id}/token/{token}/groups"
payload := strings.NewReader("{\n \"name\": \"Equipe Wabox\",\n \"participants\": [\n \"5511988887777\",\n \"5511977776666\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"id": "120363012345678901-group",
"name": "Equipe Wabox",
"description": "Grupo de testes",
"owner": "5511999998888",
"created_at": "2026-08-01T10:00:00.000Z",
"participants": [
{
"phone": "5511999998888",
"lid": "123456789012345@lid",
"is_admin": true,
"is_super_admin": true
},
{
"phone": "5511988887777",
"is_admin": false,
"is_super_admin": false
}
],
"participant_count": 2,
"announce": false,
"locked": false,
"join_approval_required": false,
"member_add_mode": "all_member_add",
"ephemeral_seconds": 0,
"is_community": false,
"suspended": false
}{
"error": {
"code": "instance_not_found",
"message": "Instance not found or invalid token"
}
}{
"error": {
"code": "subscription_required",
"message": "Trial expired or subscription inactive. Subscribe in the dashboard to keep sending."
}
}{
"error": {
"code": "instance_not_connected",
"message": "Instance is not connected"
}
}Path Parameters
Id da instância (dashboard › instância › Credenciais).
Token da instância. Trate como senha.
Body
application/json
Required string length:
1 - 100Required array length:
1 - 1024 elementsMinimum string length:
1Pattern:
^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$Maximum string length:
2048Available options:
admin_add, all_member_add ephemeral_seconds
Option 1 · enum<number>Option 2 · enum<number>Option 3 · enum<number>Option 4 · enum<number>
Available options:
0 Response
Grupo criado (metadados + participantes).
Pattern:
^(\d+(-\d+)?-group|\d+(-\d+)?@g\.us)$Show child attributes
Show child attributes
Required range:
0 <= x <= 9007199254740991Required range:
0 <= x <= 9007199254740991Minimum string length:
1Pattern:
^(\d{5,20}|\d+@lid|\d+(-\d+)?-group|\d+@g\.us|\d+@newsletter|\d+@broadcast|status@broadcast)$Pattern:
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$Available options:
admin_add, all_member_add Pattern:
^(\d+(-\d+)?-group|\d+(-\d+)?@g\.us)$