---
title: "Create an Entity"
method: POST
path: "/entities"
tags: ["Entities"]
---

# Create an Entity

`POST /entities`

Create a new entity. More details on creating an entity can be found in the [Entity Overview](https://support.ironcladapp.com/hc/en-us/articles/28004816859543-Create-and-Manage-Entities) article. 

**OAuth Scope required:** `public.entities.createEntities`

## Headers

- `x-as-user-email` string
- `x-as-user-id` string

## Request body

- object
  - `name` string, required — The name of the Entity.
  - `relationshipTypeKey` string[] — The key of the relationship type to be added to the entity. The key must match a valid relationship type in the company settings. The key is displayed on the relationship types page in Data Manager and is always a single word without spaces that starts with a lowercase. For now, only one relationship type can be added or updated per entity. More info on relationship types can be found in the [Entity Relationship Types](https://support.ironcladapp.com/hc/en-us/articles/28005038398231-Create-Manage-Relationship-Types-and-Entity-Properties) article.
  - `status` 'ACTIVE' | 'INACTIVE' — The status of the entity
  - `properties` object — A key:value map of properties to add. The two below are examples. More details on the properties can be found in the [Entity Properties](https://support.ironcladapp.com/hc/en-us/articles/28005038398231-Create-Manage-Relationship-Types-and-Entity-Properties) article.
  - `parent` object — Object containing Record IDs or Ironclad IDs to be set as the parent of the current record.
    - `recordId` string, required — For post entity

## Response `201`

201

- EntityModel
  - `id` string, required — The unique identifier of the entity
  - `ironcladId` string, required — The unique Ironclad identifier of the entity
  - `name` string, required — The name of the entity
  - `status` string, required — The status of the entity
  - `lastUpdated` string, required — The last updated date of the entity
  - `properties` RecordProperties, required — The record properties associated with the record
  - `namedTypeIds` string[] — The unique identifiers of the relationship types associated with the entity
  - `parentId` string — The unique identifier of the parent entity

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404

---

[API](https://skmtc.net/ironcladapp/apis/ironclad-public-api.md) · [All operations](https://skmtc.net/ironcladapp/apis/ironclad-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ironcladapp/ironclad-public-api/versions/9459b4cfc1e0/schema)