---
title: "Create a new entity"
method: POST
path: "/entities"
tags: ["Entities"]
---

# Create a new entity

`POST /entities`

## Request body

- object
  - `name` string, required — Name of the entity to add. Should be unique.
  - `fields` object[], required
  - `endpointsGenerated` object
  - `virtual` boolean — Whether or not the entity is virtual. Default to false.

## Response `200`

Success

## Changes

- **2019-06-05** `0e4e56920ab8` — 3 breaking, 1 info
  - request body became required
  - the request property `fields` became required
  - the request property `name` became required
  - added the new optional request property `virtual`
- **2018-12-30** `d0e0b0a4b3ee` — 1 warning, 3 info
  - removed the request property `virtual`
  - request body became optional
  - the request property `fields` became optional
  - the request property `name` became optional

[Change history](https://skmtc.dev/materiahq/apis/materia-server/changes/entities/post.md)

---

[API](https://skmtc.dev/materiahq/apis/materia-server.md) · [All operations](https://skmtc.dev/materiahq/apis/materia-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/materiahq/materia-server/revisions/f4e80651bb93/schema)