POST api/v1/OrganizationalUnits

Create a new Organizational Unit

Request Information

URI Parameters

Name	Description	Type	Additional information
fields	Use this to only return the data fields you're interested in. Field names not found are ignored and no error is thrown. If no fields are found then the full object is returned.	Collection of string	None.
suppressResponseCodes	Some applications do wonky things if error codes are used. Use this to force 200s to always return.	boolean	None.
APIKey	This is your unique key that identifies you as the developer of this app. Required for all calls.	string	None.
APIToken	This is the user's session token generated when you authenticate the user	string	None.

Body Parameters

The ID field is NOT needed for this as it will be generated by the server.

OrganizationalUnit

Name	Description	Type	Additional information
ID	The ID of the OU	globally unique identifier	None.
Name	The name of the OU	string	None.
ParentID	The ID of the parent OU. This will be null if this OU is a root OU.	globally unique identifier	None.
ExternalID	The external ID of the OU.	string	None.

Request Formats

application/json, text/json

Sample:

{
  "ID": "b19980c0-ef0d-43fd-8cb4-b7f503ac275f",
  "Name": "sample string 2",
  "ParentID": "96c8fb91-0ede-4122-bede-79265aafc7b3",
  "ExternalID": "sample string 3"
}

application/x-www-form-urlencoded

Sample:

Sample not available.

Response Information

Resource Description

OrganizationalUnit

Name	Description	Type	Additional information
ID	The ID of the OU	globally unique identifier	None.
Name	The name of the OU	string	None.
ParentID	The ID of the parent OU. This will be null if this OU is a root OU.	globally unique identifier	None.
ExternalID	The external ID of the OU.	string	None.

Response Formats

application/json, text/json

Sample:

{
  "ID": "de229469-d176-4335-b61f-5550fdf35498",
  "Name": "sample string 2",
  "ParentID": "d5d7ac69-505f-46fc-a1dd-c75164531e76",
  "ExternalID": "sample string 3"
}