---
title: "Create a new Group"
method: POST
path: "/api/users/:userId/groups"
tags: ["groups"]
---

# Create a new Group

`POST /api/users/:userId/groups`

Create a new Group

## Path parameters

- `userId` string, required

## Request body

- object
  - `name` string
  - `parentId` string
  - `visibility` 'public' | 'private'

## Response `201`

Created

- object
  - `status` object
    - `code` string
  - `data` Group
    - `id` string, uuid
    - `name` string
    - `parentId` string, uuid, nullable — Parent Groups id.
    - `creator` object
      - `id` string, uuid — Group creators id
    - `visibility` 'public' | 'private'
    - `sourcePartnerObjectId` string

---

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