---
title: "Create User Group"
method: POST
path: "/v1/admin/user-groups"
tags: ["beta.admin.user-groups"]
---

# Create User Group

`POST /v1/admin/user-groups`

Create a new user group.

## Request body

- AdminUserGroupIn
  - `name` string, required — Name of the user group.
  - `description` string, nullable — Optional description of the user group.
  - `target_type` 'W' | 'O'

## Response `200`

OK

- AdminUserGroupOut
  - `uuid` string, uuid, required — User group ID.
  - `name` string, required — Name of the user group.
  - `description` string, nullable, required — Optional description of the user group.
  - `externally_managed` boolean, nullable — Whether the group is managed by an external system.
  - `target_type` 'W' | 'O'
  - `organization_role` string, nullable — Organization role assigned to the group.

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)