Create Node

Creates a node under a parent node. The node type is not chosen by the caller: it follows from the parent — a child of the platform node is an account (2), a child of an account or of a sub-account is a sub-account (3).

The parent must be active and must be your own node or below it. An account node starts in status 3 (Creating) and has no wallet yet: provision one with Create Node Wallet, then open a setup with Create Node Setup. A sub-account starts active (1).

Required permission: node:create

Request

POST /v2/admin/nodes

Headers

Name	Description
Authorization	Required. Bearer <access_token>
Content-Type	Required. application/json

Body

Field	Type	Required	Description
name	string	Yes	Node name
parent_id	string	Yes	Id of the parent node

Example

curl --request POST \
  --url '{{baseUrl}}/v2/admin/nodes' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "parent_id": "665ae536a6392b75cfd40352",
    "name": "Tostik 5"
  }'

Response

201 Created with the new node:

{
  "id": "6a4bef2b1e781b11c22e9707",
  "parent_id": "665ae536a6392b75cfd40352",
  "parent_name": null,
  "name": "Tostik 5",
  "type": 2,
  "status": 3,
  "contract": null,
  "meta": null,
  "int_id": 38,
  "path": "1.38",
  "listed_token_count": 0,
  "supervisor_count": 0,
  "created_by": "665b372f3a72d7d0791596ba",
  "created_by_supervisor": {
    "id": "665b372f3a72d7d0791596ba",
    "name": "Jane",
    "surname": "Doe",
    "email": "admin@example.com"
  },
  "created_at": "2026-03-16T12:29:59.46Z"
}

Response Fields

The response is a node object, documented field by field on Get Node, including the node type and status values. parent_name is always null in this response.

Errors

Status	Code	Description
400	10015	Validation failed (missing name or parent_id) — see details
400	10016	parent_id is not a valid id
400	10003	Parent node not found (node domain 2)
400	10020	The parent node is not active (node domain 2)
403	10005	The parent node is outside your part of the hierarchy (node domain 2)

See Errors for the error format and common codes.