BU: Business Unit
A business unit within a legal entity, containing divisions and tracking regional KPIs like revenue and headcount.
Default definition. This article describes the default
BU definition shipped with DemandFlow. Administrators can add, remove, rename, or re-type fields, change which ones are required, and alter the layout from the Definitions screen in Settings. Your tenant's current schema may differ from what is shown here. To read the current definition at any time, GET the DEFINITION object whose id matches BU.Entity properties
| Property | Value |
|---|---|
| Entity code | BU |
| Display name | Business Unit |
| Plural | Business Units |
| Level | 2000 |
Use cases
BU is the second level of the organisational hierarchy (ENT > BU > DIV > DEPT). It is linked to its parent legal entity (ENT) via entityCode using comboKeyLookup, which derives the parent from the comboKey rather than a standard objectLookup. Divisions (DIV) are children via comboKey SUB|ENT|BU|DIV. The map viewOption enables geographic visualisation of business units alongside the standard grid. KPIs are displayed via a custom metrics row type tracking headcount, revenue, operating cost, and EBITDA. Regional and country fields are simple inputs (not lookups) for flexibility.
Fields
General: Basic Info
| Field | Type | Required | Notes |
|---|---|---|---|
name | text | Yes | Business Unit Name. |
shortName | text | Short Name. | |
code | text | BU Code. | |
entityCode | comboKeyLookup | Legal Entity. | |
manager | reference → user | BU Manager. |
General: Contact & Region
| Field | Type | Required | Notes |
|---|---|---|---|
region | text | Region. | |
country | text | Country. | |
contactEmail | text | Contact Email. | |
website | text (URL) | Business Unit Link. |
Relationships
- Related lists:
DIV(formatSUB|ENT|BU|DIV).
Creating a Business Unit via the API
POST /v1/objects
Authorization: Bearer <your-pat>
Content-Type: application/json
{
"entity": "BU",
"level": 2000,
"comboKey": "SUB:<your-sub-id>|ENT:",
"name": "Business Unit Name",
"code": "BU Code",
"shortName": "Short Name",
"region": "Region"
}Listing Business Units records
GET /v1/entities/BU/SUB