Removing a member account from your organization - AWS Organizations
Before removing an account from an organizationRemoving a member account from your organizationLeaving an organization as a member account

Removing a member account from your organization

Part of managing accounts in an organization is removing member accounts that you no longer need. This page describes what you need to know before removing an account and provides procedures for removing accounts.

For information on removing the master account, see Remove the master account and delete the organization.

Before removing an account from an organization

Before you remove an account, it's important to know the following:

  • You can remove an account from your organization only if the account has the information that is required for it to operate as a standalone account. When you create an account in an organization using the AWS Organizations console, API, or AWS CLI commands, all the information that is required of standalone accounts is not automatically collected. For each account that you want to make standalone, you must accept the AWS Customer Agreement, choose a support plan, provide and verify the required contact information, and provide a current payment method. AWS uses the payment method to charge for any billable (not AWS Free Tier) AWS activity that occurs while the account isn't attached to an organization.

  • Even after the removal of created accounts (accounts created using the AWS Organizations console or the CreateAccount API) from within an organization, (i) created accounts are governed by the terms of the creating master account's agreement with us, and (ii) the creating master account remains jointly and severally liable for any actions taken by its created accounts. Customers' agreements with us, and the rights and obligations under those agreements, cannot be assigned or transferred without our prior consent. To obtain our consent, contact us at https://aws.amazon.com/contact-us/.

  • When a member account leaves an organization, that account no longer has access to cost and usage data from the time range when the account was a member of the organization. However, the master account of the organization can still access the data. If the account rejoins the organization, the account can access that data again.

Effects of removing an account from an organization

When you remove an account from an organization, no direct changes are made to the account. However, the following indirect effects occur:

  • The account is now responsible for paying its own charges and must have a valid payment method attached to the account.

  • The principals in the account are no longer affected by any service control policies (SCPs) that were defined in the organization. This means that restrictions imposed by those SCPs are gone, and the users and roles in the account might have more permissions than they had before.

  • Integration with other services might be disabled. For example, AWS Single Sign-On requires an organization to operate, so if you remove an account from an organization that supports AWS SSO, the users in that account can no longer use that service.

Removing a member account from your organization

When you sign in to the organization's master account, you can remove member accounts from the organization that you no longer need. To do this, complete the following procedure. These procedures apply only to member accounts. To remove the master account, you must delete the organization.

Note

If a member account is removed from an organization, that member account will no longer be covered by organization agreements. Master account administrators should communicate this to member accounts before removing member accounts from the organization, so that member accounts can put new agreements in place if necessary. A list of active organization agreements can be viewed in AWS Artifact Organization Agreements.

Minimum permissions

To remove one or more member accounts from your organization, you must sign in as an IAM user or role in the master account with the following permissions:

  • organizations:DescribeOrganization (console only)

  • organizations:RemoveAccountFromOrganization

If you choose to sign in as an IAM user or role in a member account in step 5, then that user or role must have the following permissions:

  • organizations:DescribeOrganization (console only).

  • organizations:LeaveOrganization – Note that the organization administrator can apply a policy to your account that removes this permission, preventing you from removing your account from the organization.

  • If you sign in as an IAM user and the account is missing payment information, the IAM user must have the permissions aws-portal:ModifyBilling and aws-portal:ModifyPaymentMethods. Also, the member account must have IAM user access to billing enabled. If this isn't already enabled, see Activating Access to the Billing and Cost Management Console in the AWS Billing and Cost Management User Guide.

To remove a member account from your organization (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You must sign in to the organization's master account.

  2. On the Accounts tab, select the check box next to the member account that you want to remove from your organization. You can choose more than one.

  3. Choose Remove account.

  4. In the Remove account dialog box, choose Remove.

    A dialog box displays the success or failure status for each account.

  5. If AWS Organizations fails to remove one or more of the accounts, it's typically because you have not provided all the required information for the account to operate as a standalone account. Perform the following steps:

    1. Sign in to one of the failed accounts.

    2. We recommend that you sign in to the member account by choosing Copy link, and then pasting it into the address bar of a new incognito browser window. If you don't use an incognito window, you're signed out of the master account and won't be able to navigate back to this dialog box.

    3. The browser takes you directly to the sign-up process to complete any steps that are missing for this account. Complete all the steps presented. They might include the following:

      • Provide contact information

      • Accept the AWS Customer Agreement

      • Provide a valid payment method

      • Verify the phone number

      • Select a support plan option

    4. After you complete the last sign-up step, AWS automatically redirects your browser to the AWS Organizations console for the member account. Choose Leave organization, and then confirm your choice in the confirmation dialog box. You are redirected to the Getting Started page of the AWS Organizations console, where you can view any pending invitations for your account to join other organizations.

To remove a member account from your organization (AWS CLI, AWS API)

You can use one of the following commands to remove a member account:

Leaving an organization as a member account

When signed in to a member account, you can remove that one account from its organization. To do this, complete the following procedure. The master account can't leave the organization using this technique. To remove the master account, you must delete the organization.

Note

If you leave an organization, you will no longer be covered by organization agreements that were accepted on your behalf by the master account of the organization. You can view a list of these organization agreements in AWS Artifact Organization Agreements. Before leaving the organization, you should determine (with the assistance of your legal, privacy, or compliance teams where appropriate) whether it is necessary for you to have new agreement(s) in place.

Minimum permissions

To leave an AWS organization, you must have the following permissions:

  • organizations:DescribeOrganization (console only).

  • organizations:LeaveOrganization – Note that the organization administrator can apply a policy to your account that removes this permission, preventing you from removing your account from the organization.

  • If you sign in as an IAM user and the account is missing payment information, the IAM user must have the permissions aws-portal:ModifyBilling and aws-portal:ModifyPaymentMethods. Also, the member account must have IAM user access to billing enabled. If this isn't already enabled, see Activating Access to the Billing and Cost Management Console in the AWS Billing and Cost Management User Guide.

Note

An account’s status with an organization affects what cost and usage data is visible:

  • When a standalone account joins an organization, the account no longer has access to cost and usage data from the time range when the account was a standalone account.

  • If a member account leaves an organization and becomes a standalone account, the account no longer has access to cost and usage data from the time range when the account was a member of the organization. The account has access only to the data that is generated as a standalone account.

  • If a member account leaves organization A to join organization B, the account no longer has access to cost and usage data from the time range when the account was a member of organization A. The account has access only to the data that is generated as a member of organization B.

  • If an account rejoins an organization that it previously belonged to, the account regains access to its historical cost and usage data.

To leave an organization as a member account (console)

  1. Sign in to the Organizations console at https://console.aws.amazon.com/organizations/. You can sign in as an IAM user with the required permissions, or as the root user of the member account that you want to remove from the organization. By default, you don't have access to the root user password in a member account that was created using AWS Organizations. If required, recover the root user password by following the steps at Accessing a member account as the root user.

  2. On the Organization overview page, choose Leave organization.

  3. Perform one of the following steps:

    • If your account has all the required information to operate as a standalone account, a confirmation dialog box appears. Confirm your choice to remove the account. You are redirected to the Getting Started page of the AWS Organizations console, where you can view any pending invitations for your account to join other organizations.

    • If your account doesn't have all the required information, perform the following steps:

      1. A dialog box appears to explain that you must complete some additional steps. Click the link.

      2. Complete all the sign-up steps that are presented. They might include the following:

        • Provide contact information

        • Accept the AWS Customer Agreement

        • Provide a valid payment method

        • Verify the phone number

        • Select a support plan option

      3. When you see the dialog box stating that the sign-up process is complete, choose Leave organization.

      4. A confirmation dialog box appears. Confirm your choice to remove the account. You are redirected to the Getting Started page of the AWS Organizations console, where you can view any pending invitations for your account to join other organizations.

To leave an organization as a member account (AWS CLI, AWS API)

You can use one of the following commands to leave an organization: