Communities (Admin)

Create community (Admin)

POST/manage/communities

Create a community. The creator is automatically added as an ADMIN member. No additional permission is required beyond being signed in.

AuthLogin required

Request body

namestringrequired

Community name (required); up to 50 characters.

joinTypestringrequired

One of APPROVAL_REQUIRED / FREE_JOIN / INVITATION_ONLY.

visibilitystringoptional

One of PUBLIC / PRIVATE / LIMITED.

descriptionstringoptional

Description; up to 500 characters.

languagesLanguagesoptional

Localized name / description.

logoUrlstringoptional

Logo image URL; must be a valid URL.

contactContact[]optional

Contact information.

tagsstring[]optional

Array of tag names.

slugstringoptional

3–200 characters; lowercase alphanumerics, hyphens and underscores only (^[a-z0-9-_]+$). Must be unique.

Response

Returns Community.

Request
curl https://api.4s.link/manage/communities \
-X POST \
-H "Authorization: Bearer 4s_at_..." \
-H "Content-Type: application/json" \
-d '{
"name": "Tech Community",
"joinType": "FREE_JOIN",
"visibility": "PUBLIC"
}'
Example response
{
"id": "c1a2b3c4-...",
"slug": "tech-community",
"name": "Tech Community",
"description": "...",
"joinType": "FREE_JOIN",
"visibility": "PUBLIC",
"logoUrl": "https://.../logo.png",
"logoDarkUrl": null,
"enabledChat": true,
"tags": []
}