---
title: "Create a new business entity"
method: POST
path: "/v1/organization/business_entities"
tags: ["Organization management"]
---

# Create a new business entity

`POST /v1/organization/business_entities`

This endpoint creates a new business entity.

## Request body

- object
  - `parentID` string, uuid, required
  - `name` string, required — The name of the new business entity.
  - `description` string — The description of the new business entity.
  - `countryCode` string — The country code of the business entity.
  - `subIndustryCode` string — The sub-industry code of the business entity or functional unit, formatted as eight digits.
  - `facilityTypeID` string, uuid, nullable — The facility type of the business entity if it is a facility.
  - `processTypeID` string, uuid, nullable — The process type of the business entity if it is a process.
  - `businessEntityTypeID` string, uuid, required
  - `defaultFunctionalUnitID` string, uuid
  - `customFunctionalUnitName` string — The name of the custom functional unit for the business entity. If you want to define a custom functional unit for the business entity, make sure to set this parameter.
  - `defaultDisplayUnit` string — The default display unit for the functional unit of the business entity. If you want to define a custom functional unit for the business entity, make sure to set this parameter.
  - `activeStartTimestamp` number — The timestamp when the business entity becomes active, in milliseconds since epoch.
  - `activeEndTimestamp` number — The timestamp when the business entity becomes inactive, in milliseconds since epoch.

## Response `201`

Business entity successfully created

- BusinessEntity
  - `id` string, uuid, required
  - `orgID` string, uuid
  - `parentID` string, uuid, nullable
  - `name` string, required — The name of the business entity
  - `description` string — A description of the business entity
  - `countryCode` string — The country code of the business entity.
  - `subIndustryCode` string, nullable — The sub-industry code of the business entity or functional unit, formatted as eight digits.
  - `facilityTypeID` string, uuid, nullable — The facility type of the business entity if it is a facility.
  - `processTypeID` string, uuid, nullable — The process type of the business entity if it is a process.
  - `businessEntityTypeID` string, uuid
  - `defaultFunctionalUnitID` string, uuid
  - `defaultDisplayUnit` string — The default display unit for the functional unit of the business entity
  - `activeStartTimestamp` number — The timestamp when the business entity becomes active, in milliseconds since epoch
  - `activeEndTimestamp` number — The timestamp when the business entity becomes inactive, in milliseconds since epoch

## Other responses

- `403` — You are not authorized to acess this object

---

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