---
title: "Create External Demand Org Unit"
method: POST
path: "/api/v2/resource_management/ext-systems/resourcing/ext-demand-org-units"
tags: ["Ext Demand Org Unit"]
---

# Create External Demand Org Unit

`POST /api/v2/resource_management/ext-systems/resourcing/ext-demand-org-units`

## Request

- Base URL: `https://apiv2.eightfold.ai`
- URL: `https://apiv2.eightfold.ai/api/v2/resource_management/ext-systems/resourcing/ext-demand-org-units`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/eightfold/apis/api-server-v2-service-service/docs/api/v2/resource_management/ext-systems/resourcing/ext-demand-org-units/post.ts> (a function with typed inputs; its response is checked against the schema)

Create a new External Demand Org Unit

## Headers

- `Authorization` string, required

## Request body

- ExtDemandOrgUnitSchema
  - `status` 'active' | 'archived', required: Status of the org unit. Possible values: ['active', 'archived']
  - `updatedBy` string, nullable: Email of the updater of the org unit
  - `userGroups` RmUserGroup[], nullable: User groups associated with the org unit
    - `userGroupId` string, nullable: Unique identifier for the user group
  - `extOrgUnitId` string, required: Org unit id in the external system
  - `_type` 'program' | 'project', required: Type of the org unit. Possible values: ['program', 'project']
  - `mainOwner` DemandOrgUnitOwnerSchema
    - `email` string, required: Email of the owner
    - `name` string, nullable: Name of the owner
  - `endDate` string, nullable: End date of the org unit in ISO format (YYYY-MM-DD)
  - `createdBy` string, required: Email of the creator of the org unit
  - `description` string, nullable: Description of the org unit
  - `otherOwners` DemandOrgUnitOwnerSchema[], nullable: Other owners of the org unit
    - `email` string, required: Email of the owner
    - `name` string, nullable: Name of the owner
  - `parentExtId` string, nullable: Parent org unit id in the external system
  - `startDate` string, required: Start date of the org unit in ISO format (YYYY-MM-DD)
  - `updatedAt` integer, nullable: Updated timestamp for the org unit
  - `customFields` object, nullable: Custom fields for the org unit
  - `title` string, required: Title of the org unit
  - `tags` EntityTag[], nullable: Tags associated with the org unit
    - `type` 'user' | 'system', required: Type of the tag (user/system)
    - `name` string, required: Name of the tag
    - `category` 'inherited_tag' | 'null', nullable: Category of the tag (e.g. inherited_tag)

## Response `200`

OK

- ExtDemandOrgUnitSchema
  - `status` 'active' | 'archived', required: Status of the org unit. Possible values: ['active', 'archived']
  - `updatedBy` string, nullable: Email of the updater of the org unit
  - `userGroups` RmUserGroup[], nullable: User groups associated with the org unit
    - `userGroupId` string, nullable: Unique identifier for the user group
  - `extOrgUnitId` string, required: Org unit id in the external system
  - `_type` 'program' | 'project', required: Type of the org unit. Possible values: ['program', 'project']
  - `mainOwner` DemandOrgUnitOwnerSchema
    - `email` string, required: Email of the owner
    - `name` string, nullable: Name of the owner
  - `endDate` string, nullable: End date of the org unit in ISO format (YYYY-MM-DD)
  - `createdBy` string, required: Email of the creator of the org unit
  - `description` string, nullable: Description of the org unit
  - `otherOwners` DemandOrgUnitOwnerSchema[], nullable: Other owners of the org unit
    - `email` string, required: Email of the owner
    - `name` string, nullable: Name of the owner
  - `parentExtId` string, nullable: Parent org unit id in the external system
  - `startDate` string, required: Start date of the org unit in ISO format (YYYY-MM-DD)
  - `updatedAt` integer, nullable: Updated timestamp for the org unit
  - `customFields` object, nullable: Custom fields for the org unit
  - `title` string, required: Title of the org unit
  - `tags` EntityTag[], nullable: Tags associated with the org unit
    - `type` 'user' | 'system', required: Type of the tag (user/system)
    - `name` string, required: Name of the tag
    - `category` 'inherited_tag' | 'null', nullable: Category of the tag (e.g. inherited_tag)

---

[API](https://skmtc.dev/eightfold/apis/api-server-v2-service-service.md) - [All operations](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/llms.txt) - [OpenAPI document](https://skmtc.dev/eightfold/apis/api-server-v2-service-service/revisions/9a8b3a927e93?raw)