---
title: "Create a new empty group"
method: POST
path: "/v1/groups"
tags: ["Groups"]
---

# Create a new empty group

`POST /v1/groups`

## Response `200`

Group created 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.

## Changes

- **2024-11-25** `32a04b45196c` — 1 info
  - api tag `Groups` added
- **2024-11-25** `72a2dfa26976` — 1 info
  - endpoint added
- **2024-11-18** `b5092f204599` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/btcpayserver/apis/nbxplorer-api/changes/v1/groups/post.md)

---

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