Creating an organization
You can create an organization that starts with your Amazon Web Services account as the management account. When you create an organization, you can choose whether the organization supports all features (recommended) or only consolidated billing features.
After creating an organization, you can add accounts to your organization in these ways from the management account:
-
Create other Amazon Web Services accounts that are automatically added to your organization as member accounts
-
After verifying your email address, invite existing Amazon Web Services accounts to join your organization as member accounts
Create an organization
You can create an organization by using either the Amazon Web Services Management Console or by using a command from the Amazon CLI or one of the SDK APIs.
Minimum permissions
To create an organization with your current Amazon Web Services account, you must have the following permissions:
-
organizations:CreateOrganization
-
iam:CreateServiceLinkedRole
You can restrict this permission to only the service principal
organizations.amazonaws.com
.
To create an organization
-
Sign in to the Amazon Organizations console
. You must sign in as an IAM user, assume an IAM role, or sign in as the root user (not recommended) in the organization’s management account. -
By default, the organization is created with all features enabled. However, you can choose either of the following steps:
-
To create an organization with all features enabled, on the introduction page, choose Create an organization.
-
To create an organization with Consolidated Billing features only, on the introduction page and under Create an organization, choose consolidated billing features, and then in the confirmation dialog box, choose Create an organization.
If you accidentally choose the wrong option, you can immediately go to the Settings
page, and then choose Delete organization and start over. -
-
The organization is created and the Amazon Web Services accounts
page appears. The only account present is your management account, and it's currently stored in the root organizational unit (OU). If required, Organizations automatically sends a verification email to the address that is associated with your management account. There might be a delay before you receive the verification email. Verify your email address within 24 hours. For more information, see Email address verification. You can create accounts to grow your organization without verifying your management account's email address. However, to invite existing accounts, you must first complete email verification.
Note
If this account previously verified its email address, then it doesn't happen again when you use the account to create an organization.
The following code examples show how to use CreateOrganization
.
Now you can add additional accounts to your organization as follows:
-
To create an Amazon Web Services account that automatically becomes part of your Amazon organization, see Creating a member account in your organization.
-
To invite an existing account to your organization, see Inviting an Amazon Web Services account to join your organization.
Email address verification
After you create an organization and before you can invite accounts to join, you must verify that you own the email address provided for the management account in the organization.
When you create an organization, if the management account has not been previously verified, Amazon automatically sends a verification email to the specified email address. There might be a delay before you receive the verification email.
Within 24 hours, follow the instructions in the email to verify your email address.
If you don't verify your email address within 24 hours, you can resend the verification request so that you can invite other Amazon Web Services accounts to your organization. If you don't receive the verification email, check that your email address is correct and, if necessary, modify it.
-
To find out what email address is associated with your management account, see Viewing the details of an organization from the management account.
-
To change the email address that is associated with your management account, see Managing an Amazon Web Services account in the Amazon Billing User Guide.
If you change the email address of the management account, the account's status reverts to "email unverified," and you must complete the verification process for your new email address.
Note
If you invited accounts to join your organization before you changed the management account's email address and those invitations have not yet been accepted, they can’t be accepted until you verify the management account’s new email address. Use the previous procedure to resend the verification request. After you complete the process by responding to the email, your invited accounts can accept the invitations.