---
title: "Create a group (org_admin; two-step)"
method: POST
path: "/api/orgs/{orgId}/groups"
tags: ["groups"]
---

# Create a group (org_admin; two-step)

`POST /api/orgs/{orgId}/groups`

## Request

- Base URL: `https://api.wizbi.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.wizbi.ai/api/orgs/{orgId}/groups`
- Auth: none declared

## Path parameters

- `orgId` string, required

## Request body

- CreateGroupBody
  - `name` string, required
  - `description` string
  - `parentGroupId` string
  - `confirm` boolean: false = return a preview only; true = apply the change.

## Response `200`

Preview.

- object
  - `preview` object, required

## Other responses

- `201`: Created.
- `403`: Insufficient role.

---

[API](https://skmtc.dev/wizbi/apis/wizbi-core-api.md) · [All operations](https://skmtc.dev/wizbi/apis/wizbi-core-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wizbi/apis/wizbi-core-api/revisions/5a47416c82ec?raw)