Groups

Create a community

Creates a WhatsApp community (a parent group). The linked announcement group is created automatically by the server. Participants are optional, so a community can be created solo.

POST
/communities

Creates a WhatsApp community (a parent group). The linked announcement group is created automatically by the server. Participants are optional, so a community can be created solo.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Payload for creating a WhatsApp community (parent group).

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/communities" \  -H "Content-Type: application/json" \  -d '{    "name": "Comunidade WUTS",    "participants": []  }'
{  "success": true,  "community": {}}
{  "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"}

Add group participants POST

Adds participants to a WhatsApp group. The default action is add, but an explicit action (add, remove, promote, demote) may be supplied in the body to override it. Returns the per-participant result from WUTS.

Create a group POST

Creates a new WhatsApp group with the given name and participants. Optional flags configure announcement mode, locking, join approval, and community linkage through the WUTS gateway.