---
title: "Create a new group"
method: POST
path: "/api/group"
tags: ["Groups"]
---

# Create a new group

`POST /api/group`

Creates a new group in the system. Only authorized administrators can create groups.

## Request body

- GroupCreate
  - `name` string, required
  - `inbound_tags` string[], required
  - `is_disabled` boolean

## Response `201`

Successful Response

- GroupResponse
  - `name` string, required
  - `inbound_tags` string[], nullable
  - `is_disabled` boolean
  - `id` integer, required
  - `total_users` integer

## Other responses

- `401` — Unauthorized Error
- `403` — Forbidden Error
- `422` — Validation Error

---

[API](https://skmtc.dev/socialser/apis/pasarguardapi.md) · [All operations](https://skmtc.dev/socialser/apis/pasarguardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socialser/pasarguardapi/revisions/4b082bbcb6c3/schema)