---
title: "CreateGroup creates a new group with an admin account address, a list of members and some optional metadata."
method: POST
path: "/cosmos.group.v1.Msg/CreateGroup"
tags: ["Msg"]
---

# CreateGroup creates a new group with an admin account address, a list of members and some optional metadata.

`POST /cosmos.group.v1.Msg/CreateGroup`

## Request body

- CosmosGroupV1MsgCreateGroup — MsgCreateGroup is the Msg/CreateGroup request type.
  - `admin` string — admin is the account address of the group admin.
  - `members` CosmosGroupV1MemberRequest[] — members defines the group members.
    - `address` string — address is the member's account address.
    - `metadata` string — metadata is any arbitrary metadata attached to the member.
    - `weight` string — weight is the member's voting weight that should be greater than 0.
  - `metadata` string — metadata is any arbitrary metadata to attached to the group.

## Response `200`

A successful response.

- CosmosGroupV1MsgCreateGroupResponse — MsgCreateGroupResponse is the Msg/CreateGroup response type.
  - `group_id` string, uint64 — group_id is the unique ID of the newly created group.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2025-05-21** `3874a03b0e7b` — 1 info
  - api operation id `UpgradeMsg_CreateGroup` removed and replaced with `EvidenceMsg_CreateGroup`
- **2025-05-09** `8dbfaa2bebb2` — 1 info
  - api operation id `CircuitMsg_CreateGroup` removed and replaced with `UpgradeMsg_CreateGroup`
- **2025-04-08** `21a675703a05` — 1 info
  - api operation id `AuthMsg_CreateGroup` removed and replaced with `CircuitMsg_CreateGroup`
- **2025-03-27** `4f349536c8f3` — 1 info
  - api operation id `FeegrantMsg_CreateGroup` removed and replaced with `AuthMsg_CreateGroup`
- **2025-02-24** `2ab9d24288c2` — 1 info
  - api operation id `CircuitMsg_CreateGroup` removed and replaced with `FeegrantMsg_CreateGroup`

[Full history](https://skmtc.dev/pokt-network/apis/http-api-console/changes/cosmos.group.v1.Msg/CreateGroup/post.md)

---

[API](https://skmtc.dev/pokt-network/apis/http-api-console.md) · [All operations](https://skmtc.dev/pokt-network/apis/http-api-console/llms.txt) · [OpenAPI document](https://skmtc.dev/pokt-network/apis/http-api-console/revisions/671fab54b729?raw)