# Managing Organizations Organizations allow you to model your resource hierarchy so that it matches your actual organizational setup. Organizations can be parent nodes for other organizations or for projects. ![](https://docs.equinix.com/assets/images/organizations-create-hierarchy-dc16d7ee301f5398de9b9514d1365fa7.png) Here are some important definitions: **Root Organization** Root Organization is a legal entity created in Equinix IAM platform that is a legal parent of more than one customer organizations. Generally, no users can gain access to the root organization and hence any changes requiring access to root will be routed through CSMs. **First Level Organization** A First Level Organization is a legal entity created in Equinix IAM platform. There are 3 ways to create a first level organization: * Whenever a new billing account is created. * When a customer uses self-service onboarding to onboard to Equinix platform. * A user with access to root organization can create a first level organization. Every first level organization has exactly one root organization as their parent. **Second Level Organization** A Second Level Organization is a logical grouping that user can use to organize their assets in a way that makes sense to them. For example, by creating departments. ## Example Organization[​](#example-organization "Direct link to Example Organization") ![](https://docs.equinix.com/assets/images/organizations-create-example-b962596c73f2cd7ba6c761dc499eb950.png) In this example, the root organization hosts two organizational units: * Tres Commas – Standard customer organization that can be used for internal projects purposes * Moonshot – Reseller organization for managing your end-customers organizations and projects The reseller organization is divided into two sub-units that serve domestic and international end-customers. The sub-unit that handles the international end-customers is further divided into organizations that do business in specific countries. ## Creating a First Level Organization[​](#creating-a-first-level-organization "Direct link to Creating a First Level Organization") > **Note** > > Only customers with access to root organizations or CSMs can create first level organizations. When you create a first level organization, a new customer organization, which is a new legal entity, will be created as a first level organization under the root organization, and will be synced with Equinix Customer Portal. Typically, for customers, a first level organization is automatically created when they either use [self-service onboarding](https://docs.equinix.com/customer-portal.md) to onboard themselves to Equinix Platform, or when a [new billing account](https://docs.equinix.com/billing/create-billing-account.md) is created. To create an organization: 1. Sign in to Equinix Customer Portal as an Org Admin. 2. Navigate to *Resource Management* in the left navigation menu 3. Locate the parent Organization of the new organization, and from the options menu select **Create Organization**. 4. Enter the **Organization Name** . 5. Click **Done**. ## Creating a Second Level Organization[​](#creating-a-second-level-organization "Direct link to Creating a Second Level Organization") To create a Second Level organization: 1. Sign in to Equinix Customer Portal as an Org Admin or a Partner Admin user. 2. Navigate to **Resource Management** in the left navigation menu 3. Locate the parent Organization of the new organization, and from the options menu select **Create Organization**. ![2nd level organization creation](https://docs.equinix.com/assets/images/organizations-create-second-level-org-4935816d37ada370e476c9ae8ddd1ebf.png) 4. Enter the **Organization Name** . 5. Click **Done**. ## Viewing an Organization's Details[​](#viewing-an-organizations-details "Direct link to Viewing an Organization's Details") View organization's identifier and directly assigned billing accounts. To view organization details: 1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal. 2. Click **Resources**. 3. Locate the desired organization, then from the options menu select **View Details**. ## Editing Organizations[​](#editing-organizations "Direct link to Editing Organizations") Update the organization's name to reflect changes in your or your customer's organization structures. > **Note** > > First Level Organizations cannot be renamed. To edit an organization: 1. Sign in to Equinix Customer Portal as an Org Admin user. 2. Navigate to *Resource Management* in the left navigation menu. 3. Locate the desired organization, then from the options menu select **Edit Name**. ![](https://docs.equinix.com/assets/images/organizations-manage-edit-name-5ec265576f76fd060fc5683a6e5f7024.png) 4. Edit the organization's name and click **Save**. ## Moving Organizations[​](#moving-organizations "Direct link to Moving Organizations") Move organizations to reorganize your resource hierarchy structure. When you move organizations or projects from a source organization to a destination organization, keep in mind that: * Users and roles assigned directly to the organization or project being moved still have access to it. * Users and roles inherited from the source organization above the hierarchy no longer have access to it, while users from the destination organizations acquire access and roles through inheritance. * Billing accounts from the source organization cannot be used to make new orders once the organization or project is moved. New orders can be made using the billing accounts inherited from the destination organization. * Changing organization or project billing account assignments during the move doesn't affect the invoicing of existing assets. To move an organization: 1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as an Org Admin user. 2. Click **Resources**. 3. Locate the desired organization, then from the options menu select **Move Organization**. 4. Select the new parent organization and click **Done**. ## Merging Organizations[​](#merging-organizations "Direct link to Merging Organizations") Merge a source organization to a destination organization to consolidate the assets and users under the destination organization. ### Effects[​](#effects "Direct link to Effects") Users: * All users from the source organization will be moved into the destination organization. * If there are duplicated users - users with the same first name, last name and email address in both organizations; the user in the source organization will be merged into the destination organization user. The user’s permissions in the source organization will be copied over to the user in the destination. The duplicated user will now only need 1 user account to log in and still retains all of the existing permissions. * However, if it is a duplicated user with IBX access, the user account will not be combined. The user will have 2 user accounts for the same organization. Assets: * All assets will be moved from under the source organization to the destination organization. * The default project in the source organization will be merged with the default project in the destination. There will only be 1 default project in any organization. * Existing non-default projects in the source organization will be moved under the destination organization. It will not be removed. Billing Account: * All billing accounts will be moved from under the source organization to the destination organization. Reseller: * If the Source Organization is a Reseller Organization, all existing customers under the Reseller will be moved under the Destination Organization as well > **Warning** > > The merging process moves the selected customer organizations under a new parent customer organization. Merging can take up to 10 minutes and is irreversible. During this period, the newly created parent customer organization remains grayed-out and cannot be modified. ### Types of Organization Merges[​](#types-of-organization-merges "Direct link to Types of Organization Merges") | Source Organization Type | Destination Organization Type | Final Resulting Organization Type | | ------------------------ | ----------------------------- | --------------------------------- | | Normal | Normal | Normal | | Reseller | Reseller | Reseller | | Normal | Reseller | Reseller | | Reseller | Normal | Reseller | | Subcustomer | Subcustomer | Subcustomer | > **Note** > > If any of the organization is a Reseller, the final organization will always be a reseller because the Reseller billing account and customers(if any) will be in the destination organization. ### Performing a Merge[​](#performing-a-merge "Direct link to Performing a Merge") **Pre-requisites**: Both organizations must be under the same Root Organization before they can be merged. 1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as an Org Admin user. 2. Navigate to **Resource Management** through the left navigation menu. 3. Locate the desired organization. This is your source organization. From the options menu, select **Merge Organization**. ![](https://docs.equinix.com/assets/images/organizations-merge-org-107fe1d0a4de8349604eaa8c2e18166c.png) 4. Select the destination organization. ![](https://docs.equinix.com/assets/images/organizations-merge-org-select-d6234b92a1b6cad692a2b37731a16ffd.png) 5. Review your selections and click **Merge** to complete. Users, users permissions, billing accounts and assets will be merged from the source into the destination organization. > **Warning** > > This action is not reversible. Make sure your selections are accurate before performing the merge. ### End-Customer Organization Merge[​](#end-customer-organization-merge "Direct link to End-Customer Organization Merge") Merging End-Customer Organizations follows the same steps as merging organizations above. You need to make sure that end customer organizations are selected as source and destination organizations. > **Note** > > Only End-Customers Organizations under the same Reseller Organization can be merged together 1. Sign in to the [Identity & Access Management](https://portal.equinix.com/iam/accessmanagement/resources) portal as: * an IAM Admin * an Organization Admin * a Partner Admin * an End Customer Admin user 2. Navigate to *Resource Management* through the left navigation menu. 3. Locate an *End Customer Organization*. This is your source organization.From the options menu, select **Merge Organization**. ![](https://docs.equinix.com/assets/images/organizations-merge-org-107fe1d0a4de8349604eaa8c2e18166c.png) 4. Select the destination organization. The destination organization must belong under the same Reseller Organization. ![](https://docs.equinix.com/assets/images/organizations-merge-org-select-d6234b92a1b6cad692a2b37731a16ffd.png) 5. Review your selections and click **Merge** to complete. Users, users permissions, billing accounts and assets will be merged from the source into the destination organization. > **Warning** > > This action is not reversible. Make sure your selections are accurate before performing the merge. ## Deleting Organizations[​](#deleting-organizations "Direct link to Deleting Organizations") Delete organizations to reflect changes in your internal operational structures and customer's engagements. > **Note** > > You cannot delete first-level organizations. Only second-level organizations and below can be deleted. Clicking on first-level organizations will not display the option to delete. To delete an organization: 1. Sign in to Equinix Customer Portal as an Org Admin user. 2. Navigate to *Resource Management* in the left navigation menu. 3. Locate the desired organization and from the options menu select **Delete Organization**. 4. Click **Delete** to proceed.