Create new communities with custom settings, privacy controls, post moderation, and metadata to build engaging spaces for your users
createCommunity()
method establishes a new community with comprehensive customization options for privacy, content moderation, and branding. Create communities that perfectly match your app’s requirements and user engagement goals.
Parameter | Type | Required | Description |
---|---|---|---|
displayName | String | Yes | Public display name visible to all users who can access the community |
description | String | No | Community description explaining purpose and focus |
isPublic | Boolean | No | Community visibility: true for public, false for private (default: true ) |
avatar | Image | No | Community avatar image for visual branding |
categoryIds | Array | No | List of category IDs for community organization |
postSettings | Enum | No | Content moderation settings for posts |
storySettings | Object | No | Story interaction and moderation configuration |
metadata | Object | No | Custom fields and properties for specialized features |
Setting | Description | Discovery | Join Behavior |
---|---|---|---|
Public Community | Discoverable by all users | Visible in search and browse | Can join immediately or require approval |
Private Community | Invitation-only access | Hidden from public discovery | Requires invitation or approval |
Option | Description | Use Case |
---|---|---|
ANYONE_CAN_POST | All members can post freely | Open communities with high trust |
ADMIN_REVIEW_POST_REQUIRED | Posts require moderator approval | Controlled content communities |
ONLY_ADMIN_CAN_POST | Only moderators can create posts | Announcement-only communities |
Setting | Type | Description | Default |
---|---|---|---|
allowComment | Boolean | Enable/disable comments on community stories | true |