All Products
Search
Document Center

Identity as a Service:CreateOrganizationalUnit

Last Updated:Mar 30, 2026

Creates an organizational unit.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/{instanceId}/{applicationId}/organizationalUnits HTTP/1.1

Path Parameters

Parameter

Type

Required

Description

Example

instanceId

string

Yes

The instance ID.

idaas_ue2jvisn35ea5lmthk267xxxxx

applicationId

string

Yes

The application ID.

app_mkv7rgt4d7i4u7zqtzev2mxxxx

Request parameters

Parameter

Type

Required

Description

Example

Authorization

string

Yes

The authentication information. Format: Bearer ${access_token}. Example: Bearer ATxxxx.

Bearer AT8csE2seYxxxxxij

body

object

No

The request body.

app_xx001

organizationalUnitName

string

Yes

The name of the organizational unit.

name001

parentId

string

Yes

The ID of the parent organizational unit.

ou_wovwffm62xifdziem7an7xxxxx

organizationalUnitExternalId

string

No

The external ID of the organizational unit. The external ID can be used to map external data to the data of the organizational unit in Employee Identity and Access Management (EIAM) of Identity as a Service (IDaaS). By default, the external ID is the organizational unit ID.

For organizational units with the same source type and source ID, each organizational unit has a unique external ID.

ou_wovwffm62xifdziem7an7xxxxx

description

string

No

The description of the organizational unit.

测试组织

Response elements

Element

Type

Description

Example

object

The response parameters.

organizationalUnitId

string

The ID of the organizational unit.

ou_wovwffm62xifdziem7an7xxxxx

Examples

Success response

JSON format

{
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.