---
title: "Create Organization Group"
method: POST
path: "/api/platform/organizations/{org_id}/groups"
tags: ["platform"]
---

# Create Organization Group

`POST /api/platform/organizations/{org_id}/groups`

Create a group, mirror its org tuple, and grant the creator ownership.

Creating a group requires module ``editor``. The new group is registered as
a ``sharable_entity`` under the members-groups module instance and the
creator is granted ``owner`` + ``data_owner`` on it, so they retain full
control of the group they just made.

## Path parameters

- `org_id` string, required

## Request body

- CreatePlatformGroupRequest — Body for creating a group under an organization.
  - `groupId` string, required — Short id (letters, digits, hyphen/underscore).
  - `displayName` string, nullable — Human-readable name. Defaults to the group id when omitted.

## Response `201`

Successful Response

- PlatformGroup — A group belonging to an organization, with FGA mirror status.
  - `id` string, required
  - `organizationId` string, required
  - `organizationName` string, nullable
  - `displayName` string, nullable
  - `description` string, nullable
  - `memberCount` integer
  - `isAllMembers` boolean
  - `fgaSyncStatus` string
  - `fgaLastError` string, nullable
  - `fgaLastReconciledAt` string, date-time, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)