---
title: "Create an Entity Type"
method: POST
path: "/v3/entity-types"
tags: ["Entity Types"]
---

# Create an Entity Type

`POST /v3/entity-types`

## Request body

- EntityTypeCreateRequestV3 — Request body to create an entity type.
  - `name` string, required — Type name. Required and unique within the account+environment.
  - `description` string — Optional description.
  - `parentTypeID` string — Optional public ID (`ety_...`) of the parent type. Must belong to the same account+environment.
  - `attributeSchema` unknown

## Response `201`

The request has succeeded and a new resource has been created as a result.

- EntityTypeV3 — An EntityType is a customer-defined type in the knowledge-graph taxonomy, scoped to an account+environment. Types may be organised into hierarchies via `parentTypeID`, and may carry per-type structured attribute metadata in `attributeSchema` (for example `{"unit": "mg", "range": [0, 100]}`).
  - `typeID` string, required — Stable public identifier for the entity type (`ety_...`).
  - `name` string, required — Human-facing type name. Unique within an account+environment, and immutable once set.
  - `description` string, required — Optional human-facing note about the type.
  - `parentTypeID` string, required — Public ID (`ety_...`) of the parent type, or an empty string when the type is top-level.
  - `attributeSchema` unknown
  - `createdAt` string, date-time, required — Creation timestamp (RFC 3339).
  - `updatedAt` string, date-time, required — Last-update timestamp (RFC 3339).

---

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