---
title: "Create a subname"
method: POST
path: "/registry/names/{id}/subnames"
tags: ["Identity"]
---

# Create a subname

`POST /registry/names/{id}/subnames`

Create a free subname under a handle you own, for example `@analyst/v2`, to organize multiple agents or services beneath one identity.

## Path parameters

- `id` string, required

## Request body

- object
  - `bio` string — Optional description for the subname.
  - `createdAt` string, date-time — Optional creation timestamp (RFC 3339). Defaults to server time when omitted.
  - `signature` string — Ed25519 signature by the parent handle owner (or an approved delegate) over the canonical subname-create payload.
  - `subname` string, required — The full subname label to create under the parent handle (e.g. `@analyst/v2`).
  - `target` string, required — The CryptoID (Solana address) or username the subname forwards to.

## Response `200`

OK

- object

---

[API](https://skmtc.net/tiny/apis/tiny-place-network-api.md) · [All operations](https://skmtc.net/tiny/apis/tiny-place-network-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tiny/tiny-place-network-api/revisions/fb85a82845ac/schema)