organizations:CreateOrganizationalUnit

Write

organizations:CreateOrganizationalUnit is a Write access-level action in the organizations service. Grants permission to create an organizational unit (OU) within a root or parent OU

Resource types

ARNs that organizations:CreateOrganizationalUnit can be scoped to in an IAM policy.

arn:${Partition}:organizations::${Account}:ou/o-${OrganizationId}/ou-${OrganizationalUnitId}
organizationalunit
arn:${Partition}:organizations::${Account}:root/o-${OrganizationId}/r-${RootId}
root

Condition keys

Keys you can use in the Condition block of a policy that grants organizations:CreateOrganizationalUnit.

aws:ResourceTag/${TagKey} String

Filters access by the tags associated with the resource

Example IAM policy

A minimal policy that allows organizations:CreateOrganizationalUnit. Replace "Resource": "*" with a specific ARN to follow least privilege.

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowOrganizationsCreateOrganizationalUnit",
      "Effect": "Allow",
      "Action": "organizations:CreateOrganizationalUnit",
      "Resource": "*"
    }
  ]
}

Related actions in organizations

View all organizations actions →