---
title: "Add children to a group"
method: POST
path: "/v1/groups/{groupId}/children"
tags: ["Groups"]
---

# Add children to a group

`POST /v1/groups/{groupId}/children`

Adds one or more child tracked sources (derivation schemes or other groups) to the specified group.

## Path parameters

- `groupId` string, required

## Request body

- TrackedSource[]
  - `trackedSource` string, required — The tracked source identifier, which can be a group or a derivation scheme.
  - `cryptoCode` string — The cryptocurrency code associated with the tracked source (if applicable).

## Response `200`

Children added to group 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

- `404` — Not Found. The specified group does not exist.

## Changes

- **2024-11-25** `cfaf4efd4ea8` — 2 breaking, 3 info
  - the `code` response's property type changed from `integer` to `string` for status `404`
  - removed the required property `error` from the response with the `404` status
  - added the optional property `httpCode` to the response with the `404` status
  - added the optional property `message` to the response with the `404` status
  - …1 more
- **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/:groupId/children/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)