---
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`

## Request

- Base URL: `https://api.sinai.com`
- URL: `https://api.sinai.com/v1/organization/business_entities`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://auth.sinai.com/oauth2/token` scopes: `https://api.sinai.com/organization`
  - OAuth 2
    - Authorization code: `https://auth.sinai.com/oauth2/authorize`
    - Token URL: `https://auth.sinai.com/oauth2/token`
- TypeScript: <https://skmtc.dev/sinai/apis/sinai-api/docs/v1/organization/business_entities/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/sinai/apis/sinai-api.md) - [All operations](https://skmtc.dev/sinai/apis/sinai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sinai/apis/sinai-api/revisions/495dab1b31fd?raw)