---
title: "Create or overwrite a group"
method: POST
path: "/v1/groups/{groupId}"
tags: ["Groups"]
---

# Create or overwrite a group

`POST /v1/groups/{groupId}`

Creates a new group with the specified groupId. If a group with the same groupId already exists, it will be overwritten.

## Path parameters

- `groupId` string, required

## Request body

- object
  - `children` string[] — An array of tracked sources (derivation schemes or other groups) to be included in the group.

## Response `200`

Group created or overwritten successfully.

- Group
  - `trackedSource` string, required — The tracked source identifier for the group, formatted as 'GROUP:{groupId}'. Used to reference the group within NBXplorer.
  - `groupId` string, required — The unique identifier of the group.
  - `children` object[] — An array of child tracked sources that are part of this group. Each child can be another group (nested groups) or a derivation scheme.
    - `trackedSource` string, required — The tracked source identifier of the child, which can be a group or a derivation scheme.
    - `cryptoCode` string — The cryptocurrency code associated with the child tracked source, e.g., 'BTC'. Present if the child is a derivation scheme.

## Other responses

- `400` — Bad Request. Invalid groupId or children.

---

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