---
title: "Create user group"
method: POST
path: "/management/user_groups"
tags: ["User groups (Beta)"]
---

# Create user group

`POST /management/user_groups`

## Request

- Base URL: `https://api.fireblocks.io/v1`
- URL: `https://api.fireblocks.io/v1/management/user_groups`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fireblocks/apis/fireblocks-api/docs/management/user_groups/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new user group. Users with the Viewer role cannot be added to groups.
Endpoint Permission: Admin, Non-Signing Admin.

## Headers

- `Idempotency-Key` string

## Request body

- UserGroupCreateRequest
  - `groupName` string
  - `memberIds` string[]

## Response `201`

User group created and pending approval

- CreateUserGroupResponse
  - `id` string
  - `name` string
  - `memberIds` string[]
  - `status` string

## Other responses

- `default`: Error Response

---

[API](https://skmtc.dev/fireblocks/apis/fireblocks-api.md) - [All operations](https://skmtc.dev/fireblocks/apis/fireblocks-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fireblocks/apis/fireblocks-api/revisions/4eba9965659a?raw)