日本語

Create community

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.

joinTypestring

One of APPROVAL_REQUIRED / FREE_JOIN / INVITATION_ONLY (required on create).

visibilitystring

One of PUBLIC / PRIVATE / LIMITED.

descriptionstring

Description; up to 500 characters.

languagesobject

Localized name / description.

logoUrlstring

Logo image URL; must be a valid URL.

contactobject

Contact information.

tagsstring[]

Array of tag names.

slugstring

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

Object structures

contact / organizerContact

Contact details. Pass an array of objects (up to 10). A single object is also accepted for backwards compatibility.

labelstring

Display label (e.g. "Support")

emailstring

Email address.

urlstring

URL, e.g. a contact form.

x / instagram / facebook / youtubestring

Official social accounts.

languagesobject

Localized labels ({ [lang]: { label } })

[
  {
    "label": "お問い合わせ",
    "email": "contact@example.com",
    "languages": { "en": { "label": "Contact" } }
  }
]

languages

Keyed by language code; each entry overrides the title / description shown for that language. Languages you omit fall back to the default fields.

<lang>object

Language code (ja, en, …)

<lang>.titlestring

Title shown in that language.

<lang>.descriptionstring

Description shown in that language.

{
  "ja": { "title": "オープニング基調講演", "description": "..." },
  "en": { "title": "Opening Keynote", "description": "..." }
}
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": []
}