All Products
Search
Document Center

Identity as a Service:CreateOrganizationalUnit

Last Updated:Sep 10, 2024

Creates an organizational unit.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request syntax

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

Request parameters

ParameterTypeRequiredDescriptionExample
AuthorizationstringYes

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

Bearer AT8csE2seYxxxxxij
instanceIdstringYes

The instance ID.

idaas_ue2jvisn35ea5lmthk267xxxxx
applicationIdstringYes

The application ID.

app_mkv7rgt4d7i4u7zqtzev2mxxxx
bodyobjectNo

The request body.

organizationalUnitNamestringYes

The name of the organizational unit.

name001
parentIdstringYes

The ID of the parent organizational unit.

ou_wovwffm62xifdziem7an7xxxxx
organizationalUnitExternalIdstringNo

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
descriptionstringNo

The description of the organizational unit.

test organizational unit

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

organizationalUnitIdstring

The ID of the organizational unit.

ou_wovwffm62xifdziem7an7xxxxx

Examples

Sample success responses

JSONformat

{
  "organizationalUnitId": "ou_wovwffm62xifdziem7an7xxxxx"
}

Error codes

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-10-24The internal configuration of the API is changed, but the call is not affectedView Change Details