---
title: "Create Staff Group"
method: POST
path: "/admin/staff/groups"
tags: ["Admin"]
---

# Create Staff Group

`POST /admin/staff/groups`

Create a new staff group for the current customer.
Requires admin authentication.

Supports two modes:
- members: List of StaffGroupMemberInput with user_id and optional priority_order
- member_ids: Legacy list of user IDs (for backward compatibility)

## Request body

- CreateStaffGroupRequest — Request to create a new staff group
  - `name` string, required
  - `member_ids` string[]
  - `members` StaffGroupMemberInput[], nullable
    - `user_id` string, required
    - `priority_order` integer, nullable
  - `meeting_duration_minutes` integer
  - `slot_every_minutes` integer
  - `priority_order_enabled` boolean

## Response `201`

Successful Response

- StaffGroupResponse — Response after creating or updating a staff group
  - `id` string, required
  - `name` string, required
  - `member_count` integer, required
  - `message` string, required

## Other responses

- `422` — Validation Error

---

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