Groups

List joined groups

Returns every WhatsApp group the WUTS device has joined, including announce/lock status and participant counts. Requires an active, connected WUTS session.

GET
/groups

Returns every WhatsApp group the WUTS device has joined, including announce/lock status and participant counts. Requires an active, connected WUTS session.

Authorization

bearerAuth
AuthorizationBearer <token>

Per-user API token (UUID v4) sent as Authorization: Bearer <token>. Identifies the tenant and user.

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/groups"
{  "success": true,  "groups": [    {      "jid": "120363039000000000@g.us",      "name": "WUTS Team",      "topic": "Internal coordination",      "owner": "5511999999999@s.whatsapp.net",      "created_at": "2026-01-10T14:22:00Z",      "is_announce": false,      "is_locked": false,      "join_approval": false,      "members_count": 3    }  ]}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}
{  "success": false,  "error": "validation failed",  "error_code": "VALIDATION_ERROR",  "timestamp": "2026-06-15T12:00:00Z"}

Link a group to a community POST

Adds a child group to a WhatsApp community. The path JID is the community (parent) JID and the body carries the child group JID to be linked.

Remove community participants DELETE

Removes one or more participants from a community. Uses the same WhatsApp participant mechanism as regular groups, applied to the community parent JID.