---
title: "Create a group"
method: POST
path: "/admin/groups.json"
tags: ["Groups"]
---

# Create a group

`POST /admin/groups.json`

## Request body

- object
  - `group` object, required
    - `name` string, required
    - `full_name` string
    - `bio_raw` string — About Group
    - `usernames` string — comma,separated
    - `owner_usernames` string — comma,separated
    - `automatic_membership_email_domains` string — pipe|separated
    - `visibility_level` integer
    - `primary_group` boolean
    - `flair_icon` string
    - `flair_upload_id` integer
    - `flair_bg_color` string
    - `public_admission` boolean
    - `public_exit` boolean
    - `default_notification_level` integer
    - `muted_category_ids` integer[]
    - `regular_category_ids` integer[]
    - `watching_category_ids` integer[]
    - `tracking_category_ids` integer[]
    - `watching_first_post_category_ids` integer[]

## Response `200`

group created

- object
  - `basic_group` object, required
    - `id` integer, required
    - `automatic` boolean, required
    - `name` string, required
    - `user_count` integer, required
    - `mentionable_level` integer, required
    - `messageable_level` integer, required
    - `visibility_level` integer, required
    - `primary_group` boolean, required
    - `title` string, nullable, required
    - `grant_trust_level` string, nullable, required
    - `incoming_email` string, nullable, required
    - `has_messages` boolean, required
    - `flair_url` string, nullable, required
    - `flair_bg_color` string, nullable, required
    - `flair_color` string, nullable, required
    - `bio_raw` string, nullable, required
    - `bio_cooked` string, nullable, required
    - `bio_excerpt` string, nullable, required
    - `public_admission` boolean, required
    - `public_exit` boolean, required
    - `allow_membership_requests` boolean, required
    - `full_name` string, nullable, required
    - `default_notification_level` integer, required
    - `membership_request_template` string, nullable, required
    - `members_visibility_level` integer, required
    - `can_see_members` boolean, required
    - `can_admin_group` boolean, required
    - `can_edit_group` boolean
    - `publish_read_state` boolean, required

---

[API](https://skmtc.dev/discourse/apis/discourse-api-documentation.md) · [All operations](https://skmtc.dev/discourse/apis/discourse-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discourse/discourse-api-documentation/revisions/2fd8fd2d6fd0/schema)