---
title: "Creates a new group."
method: POST
path: "/v1/groups/create"
tags: ["Groups"]
---

# Creates a new group.

`POST /v1/groups/create`

This endpoint will charge Robux for the group purchase.
Accepts "icon" and "coverPhoto" in Files object. Defaults to first file if "icon" is not present.
Http status code 413 is thrown when the group icon file size is too large.

## Response `200`

OK

- RobloxWebResponsesGroupsGroupResponseV2
  - `id` integer
  - `name` string
  - `description` string
  - `owner` RobloxWebResponsesRelatedEntityTypeResponseRobloxWebResponsesGroupsGroupOwnerType
    - `id` integer
    - `type` 0 — ['User' = 0]
    - `name` string
  - `memberCount` integer
  - `created` string, date-time
  - `hasVerifiedBadge` boolean

## Other responses

- `400` — 13: The name is invalid. 15: The group icon is invalid. 16: The group icon is missing from the request. 18: The description is too long. 19: The name is too long. 20: The name has been taken. 46: Invalid file format or dimensions for group cover photo.
- `401` — 0: Authorization has been denied for this request.
- `403` — 0: Token Validation Failed 10: User must have builders club membership. 11: User is in maximum number of groups. 12: Insufficient Robux funds. 14: The name is moderated.
- `409` — 37: The name was in use too recently.
- `413` — 0: Unknown error.
- `429` — 17: Too many requests.
- `503` — 21: Group creation is currently disabled.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/e15802062270/schema)