Toutes les routes utilisent le header x-api-key et sont préfixées par /sessions/:sessionId/.

​
Lister les groupes

GET /v1/sessions/:sessionId/groups Liste tous les groupes WhatsApp de la session.
cURL
curl https://api.waaconnect.com/v1/sessions/uuid-session-12/groups \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
Réponse 200
[
  {
    "id": "1203630XXXXXXXX@g.us",
    "subject": "Equipe Marketing",
    "desc": "Groupe officiel marketing",
    "participants": [...]
  }
]

​
Nombre de groupes

GET /v1/sessions/:sessionId/groups-count Retourne uniquement le nombre de groupes.
cURL
curl https://api.waaconnect.com/v1/sessions/uuid-session-12/groups-count \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
Réponse 200
{ "count": 7 }

​
Créer un groupe

POST /v1/sessions/:sessionId/groups Crée un nouveau groupe WhatsApp.
​
subject
string
required
Nom du groupe
​
participants
array
required
Numéros de téléphone (sans +) des membres à ajouter
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Equipe Marketing", "participants": ["22997000000", "22996000000"]}'

​
Rejoindre

POST /v1/sessions/:sessionId/groups/join Rejoindre un groupe via son code d’invitation.
​
inviteCode
string
required
Code d’invitation du groupe (sans le lien complet)
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/join \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"inviteCode": "AbCdEfGhIjkLmNoP"}'

​
Détails

GET /v1/sessions/:sessionId/groups/:groupId Retourne les métadonnées complètes d’un groupe.
​
groupId
string
required
JID du groupe (ex : 1203630XXXXXXXX@g.us)
cURL
curl https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

​
Membres

GET /v1/sessions/:sessionId/groups/:groupId/members Liste les membres d’un groupe.
cURL
curl https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/members \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
Réponse 200
{
  "groupId": "1203630XXXXXXXX@g.us",
  "count": 3,
  "members": [
    { "id": "22997000000@s.whatsapp.net", "admin": "superadmin" },
    { "id": "22996000000@s.whatsapp.net", "admin": "admin" },
    { "id": "22991000000@s.whatsapp.net" }
  ]
}

​
Modifier

PATCH /v1/sessions/:sessionId/groups/:groupId Modifie le sujet ou la description du groupe.
​
subject
string
Nouveau nom du groupe
​
description
string
Nouvelle description du groupe
cURL
curl -X PATCH https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"subject": "Equipe Marketing 2026"}'

​
Quitter

DELETE /v1/sessions/:sessionId/groups/:groupId Quitter un groupe WhatsApp.
cURL
curl -X DELETE https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"

​
Gérer les participants

POST /v1/sessions/:sessionId/groups/:groupId/participants Ajouter, retirer, promouvoir ou rétrograder des membres.
​
participants
array
required
Numéros de téléphone des membres concernés
​
action
string
required
Action à effectuer : add, remove, promote, demote
Actions disponibles
ValeurDescription
addAjouter des membres
removeRetirer des membres
promoteDonner les droits admin
demoteRetirer les droits admin
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/participants \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["22997000000"], "action": "add"}'
Réponse 200
{
  "ok": true,
  "action": "add",
  "participants": ["22997000000@s.whatsapp.net"]
}

​
Mode admins

PATCH /v1/sessions/:sessionId/groups/:groupId/privacy Active ou désactive le mode “admins uniquement” pour l’envoi de messages.
​
adminOnly
boolean
required
true = seuls les admins peuvent écrire dans le groupe
cURL
curl -X PATCH https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/privacy \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"adminOnly": true}'

​
Promouvoir

POST /v1/sessions/:sessionId/groups/:groupId/promote Promouvoir des membres comme admin.
​
participants
array
required
Numéros de téléphone des membres à promouvoir
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/promote \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["22997000000"]}'

​
Rétrograder

POST /v1/sessions/:sessionId/groups/:groupId/demote Retirer les droits admin de membres.
​
participants
array
required
Numéros de téléphone des membres à rétrograder
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/demote \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"participants": ["22997000000"]}'

​
Code d’invitation

GET /v1/sessions/:sessionId/groups/:groupId/invite-code Récupère le code d’invitation du groupe.
cURL
curl https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/invite-code \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx"
Réponse 200
{
  "groupId": "1203630XXXXXXXX@g.us",
  "inviteCode": "AbCdEfGhIjkLmNoP"
}

​
Envoyer dans le groupe

POST /v1/sessions/:sessionId/groups/:groupId/send Envoie un message texte dans un groupe.
​
message
string
required
Texte à envoyer dans le groupe
cURL
curl -X POST https://api.waaconnect.com/v1/sessions/uuid-session-12/groups/1203630XXXXXXXX@g.us/send \
  -H "x-api-key: wac_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"message": "Bonjour le groupe, point de 16h."}'

​
Envoyer un média

POST /v1/sessions/:sessionId/groups/:groupId/send-media Envoie un média dans un groupe.
​
mediaType
string
required
Type : image, video, audio, document
​
url
string
required
URL publique du média
​
mimetype
string
Type MIME du fichier
​
caption
string
Légende affichée sous le média
​
filename
string
Nom du fichier (pour document)

​
Message interactif

POST /v1/sessions/:sessionId/groups/:groupId/send-interactive Envoie un message interactif (boutons ou liste) dans un groupe. Même structure que POST /sessions/:sessionId/send-interactive, sans le champ chatId (remplacé par :groupId dans l’URL).
Réponse 200
{ "ok": true, "id": "uuid-message-451" }