---
title: "Create a new group in this account"
method: POST
path: "/accounts/{id}/groups"
tags: ["groups"]
---

# Create a new group in this account

`POST /accounts/{id}/groups`

Creates a new group and returns the definition

## Path parameters

- `id` string, required

## Request body

- GroupConfigurationPost — The configurable parts of a group
  - `name` string — Name of the group
  - `description` string — Description of the group
  - `roles` string[] — Roles grant permissions to users

## Response `200`

The group was successfully created

- Group — The current state of a group
  - `name` string — Name of the group
  - `description` string — Description of the group
  - `roles` string[] — Roles grant permissions to users
  - `href` string — A reference to this group
  - `created` string — An iso8601 formatted timestamp
  - `updated` string — An iso8601 formatted timestamp

---

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