Skip to main content

List Organizational Units

Retrieves a list of all organizational units for an account.

Basic Parameters

ParameterDescription
Customer IDThe unique ID for the customer's Google Workspace account.
As an account administrator, you can also use the my_customer alias to represent your account's customerId.
The customerId is also returned as part of the Users resource.
Org Unit PathThe full path to the organizational unit or its unique ID. Returns the children of the specified organizational unit.
TypeWhether to return all sub-organizations or just immediate children.

Advanced Parameters

ParameterDescription
Delegated User OverridePerform the action on behalf of another user, overriding the delegated user defined in the connection.

If not specified, the delegated user is the one provided in the connection.

Has no effect when using an OAuth connection.

NOTE: the connection details are not edited by this input.

Example Output

{
"etag": "ETag of the resource.",
"kind": "admin#directory#orgUnits",
"organizationUnits": [
{
"blockInheritance": false,
"description": "Description of the organizational unit.",
"etag": "ETag of the resource.",
"kind": "admin#directory#orgUnit",
"name": "The organizational unit's path name. For example, an organizational unit's name within the /corp/support/sales_support parent path is sales_support. Required.",
"orgUnitId": "The unique ID of the organizational unit.",
"orgUnitPath": "The full path to the organizational unit. The `orgUnitPath` is a derived property. When listed, it is derived from `parentOrgunitPath` and organizational unit's `name`. For example, for an organizational unit named 'apps' under parent organization '/engineering', the orgUnitPath is '/engineering/apps'. In order to edit an `orgUnitPath`, either update the name of the organization or the `parentOrgunitPath`. A user's organizational unit determines which Google Workspace services the user has access to. If the user is moved to a new organization, the user's access changes. For more information about organization structures, see the [administration help center](https://support.google.com/a/answer/4352075). For more information about moving a user to a different organization, see [Update a user](/admin-sdk/directory/v1/guides/manage-users.html#update_user).",
"parentOrgUnitId": "The unique ID of the parent organizational unit. Required, unless `parentOrgUnitPath` is set.",
"parentOrgUnitPath": "The organizational unit's parent path. For example, /corp/sales is the parent path for /corp/sales/sales_support organizational unit. Required, unless `parentOrgUnitId` is set."
}
]
}

Workflow Library Example

List Organizational Units with Google Workspace and Send Results Via Email

Workflow LibraryPreview this Workflow on desktop