Skip to main content
POST
/
api
/
v1
/
sessions
/
{sessionId}
/
communities
Manage communities
curl --request POST \
  --url https://api.wadial.com/api/v1/sessions/{sessionId}/communities \
  --header 'Authorization: Bearer <token>'

​
Create a community

POST /api/v1/sessions/{sessionId}/communities
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "subject": "Customer community",
  "description": "Product announcements and support",
  "membershipApprovalMode": "request_required",
  "createGeneralChat": true
}

​
List subgroups

GET /api/v1/sessions/{sessionId}/communities/{communityJid}/subgroups
Authorization: Bearer <api_key>

POST /api/v1/sessions/{sessionId}/communities/{communityJid}/subgroups
Authorization: Bearer <api_key>
Content-Type: application/json
Link existing groups: 
{
  "action": "link",
  "subGroupJids": ["[email protected]"]
}
Unlink groups: 
{
  "action": "unlink",
  "subGroupJids": ["[email protected]"],
  "removeOrphanedMembers": true
}
Join a linked subgroup: 
{
  "action": "join",
  "subGroupJid": "[email protected]"
}

​
List community participants

GET /api/v1/sessions/{sessionId}/communities/{communityJid}/participants
Authorization: Bearer <api_key>

​
Transfer ownership

POST /api/v1/sessions/{sessionId}/communities/{communityJid}/ownership
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "newOwnerJid": "[email protected]"
}

​
Fetch subgroup suggestions

POST /api/v1/sessions/{sessionId}/communities/{communityJid}/subgroup-suggestions
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "hintSubgroupJid": "[email protected]"
}

​
Deactivate a community

DELETE /api/v1/sessions/{sessionId}/communities/{communityJid}
Authorization: Bearer <api_key>

​
Group support helpers

Check internal-group status: 
GET /api/v1/sessions/{sessionId}/groups/{groupJid}/internal
Authorization: Bearer <api_key>
Submit a suspension appeal: 
POST /api/v1/sessions/{sessionId}/groups/{groupJid}/suspension-appeal
Authorization: Bearer <api_key>
Content-Type: application/json

{
  "reason": "This group was suspended incorrectly."
}