Manage communities

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

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.wadial.com/api/v1/sessions/{sessionId}/communities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.wadial.com/api/v1/sessions/{sessionId}/communities"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

POST

api

sessions

{sessionId}

communities

Manage communities

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

const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.wadial.com/api/v1/sessions/{sessionId}/communities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.wadial.com/api/v1/sessions/{sessionId}/communities"

headers = {"Authorization": "Bearer <token>"}

response = requests.post(url, headers=headers)

print(response.text)

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>

Link, unlink, or join a subgroup

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."
}

Get started

Guides

Build with the API

API Reference

Manage communities

Create a community

List subgroups

Link, unlink, or join a subgroup

List community participants

Transfer ownership

Fetch subgroup suggestions

Deactivate a community

Group support helpers

​Create a community

​List subgroups

​Link, unlink, or join a subgroup

​List community participants

​Transfer ownership

​Fetch subgroup suggestions

​Deactivate a community

​Group support helpers

Create a community

List subgroups

Link, unlink, or join a subgroup

List community participants

Transfer ownership

Fetch subgroup suggestions

Deactivate a community

Group support helpers