How do I move an account from an existing organization to another organization in AWS Organizations?

Resolution

Note: If you receive errors when you run AWS Command Line Interface (AWS CLI) commands, then see Troubleshooting errors for the AWS CLI. Also, make sure that you're using the most recent AWS CLI version.

Prepare for the move

Before you move your accounts, verify the following:

• You have the necessary permissions to move the management and member accounts in the organization.
  Note: If you can't leave the organization, then contact AWS Support.
• If you sign in as an AWS Identity and Access Management (IAM) user, then you must have the aws-portal:ModifyBilling and aws-portal:ModifyPaymentMethods permissions. Also, check that you activated the IAM user for access to billing.
• You have backups of reports from the member accounts that you must keep. You can't access the reports after you move the member accounts.
• You have a valid payment method on the member account for charges that you incur when you're moving the account.
• You reviewed and updated the tax information for accounts that you're moving from one organization to another.
• You changed the AWS Support plan to move developer or business accounts.
  Note: If you don't change or cancel the AWS Support plan for the developer or business accounts, then you have to pay to move those accounts.
• To share AWS resources with an account that you're moving, you must turn on resource sharing with AWS Organizations before you move the account.
• Make sure that you didn't reach your Organizations quota for the number of accounts in your organization.

Important: If you have a pricing agreement with AWS and you want to move your management account to a different organization, then contact your account manager.

Also, review the following resources:

• For information about account access, see Removing a member account from an organization with AWS Organizations.
  Note: The new organization's service control policies (SCPs) and resource control policies (RCPs) apply to the account that you move to the new organization.
• For information about reports, see What are AWS Cost and Usage Reports? and Using Detailed Billing Reports. Or, see Analyzing your costs and usage with AWS Cost Explorer for reports that you want to keep.
• For information about billing requirements, see Effective billing date, account activity, and volume discounts.
  Note: The account that you used to purchase the Savings Plan or Reserved Instance (RI) owns the Plan. If you leave the organization, then the Savings Plan or RI remains on the account that purchased it. If you need help to update the payment method for the member account, then contact AWS Support.
• AWS Organizations, moving an organization member account to another organization: Part 1
• AWS Organizations, moving an organization member account to another organization: Part 2
• AWS Organizations, moving an organization member account to another organization: Part 3

Move developer or business accounts

If you're moving only a few accounts, then use the AWS Organizations console. If you're moving numerous accounts, then use either the AWS Organizations API or AWS CLI. For more information, see Migrating an account to another organization with AWS Organizations.

Complete the following steps for each member account:

1. Remove the member account from the old organization.
2. Send an invite to the member account from the new organization.
3. Accept the invite to the new organization from the member account.

To join the old organization's management account to the new organization, complete the following steps:

1. Remove the member accounts from the organization.
2. Delete the old organization.
3. Invite the old management account to the new organization as a member account.

Related information

How do AWS Support plans work in an organization in AWS Organizations?