---
title: "Creates new group roleset."
method: POST
path: "/v1/groups/{groupId}/rolesets/create"
tags: ["Groups"]
---

# Creates new group roleset.

`POST /v1/groups/{groupId}/rolesets/create`

## Path parameters

- `groupId` integer, required

## Request body

- RobloxGroupsApiModelsRequestCreateRoleSetRequest
  - `name` string — The name of the roleset.
  - `description` string — The description of the roleset.
  - `rank` integer — The rank/positioning of the roleset.
  - `usingGroupFunds` boolean — Setting to use group funds or not.
  - `isPrivate` boolean — Optional. When true the role is only visible to members with permission to see private roles. Defaults to false (public). Only accessible to group owners.

## Response `200`

OK

- RobloxGroupsApiGroupRoleResponse — A group role response model
  - `id` integer — The role id
  - `name` string — The role name
  - `description` string — The role description
  - `rank` integer — The role rank
  - `memberCount` integer — The number of members in the role.
  - `isBase` boolean — Whether or not the role is the base role for the group
  - `color` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 — The role color. ['Invalid' = 0, 'Blue' = 1, 'Green' = 2, 'Purple' = 3, 'Yellow' = 4, 'Orange' = 5, 'Red' = 6, 'Magenta' = 7, 'Teal' = 8, 'Turquoise' = 9, 'Rust' = 10, 'Pistachio' = 11, 'Midnight' = 12, 'Lavender' = 13, 'Pink' = 14, 'Crimson' = 15, 'Plum' = 16]
  - `isPrivate` boolean — Whether the role is private (only visible to members with permission). Omitted from the response when false.

## Other responses

- `400` — 0: Something went wrong. 3: You do not have enough funds to purchase this role. 5: Role name already exists. 6: Rank value is out of bounds. 7: The role name is too long. 8: The role description is too long. 10: This group does not exist. 11: Failed to process payment to purchase role. 12: Limit for roles have been reached on this group. 14: Role name can not be empty. 15: This role does not exist.
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 9: You do not have permissions to perform this action.
- `409` — 28: Migration in progress. Please try again in a moment.

## Changes

- **2026-08-28** `997412c1cdd2` — 4 info
  - added the new optional request property `isPrivate` (media type: application/json)
  - added the new optional request property `isPrivate` (media type: text/json)
  - added the optional property `isPrivate` to the response with the `200` status (media type: application/json)
  - added the optional property `isPrivate` to the response with the `200` status (media type: text/json)

[Change history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/groups/:groupId/rolesets/create/post.md)

---

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