Skip to content

Creating a Child Tenant Account

This topic describes how to add child tenant accounts under a root tenant.

A root tenant user with Company Admin privileges creates child tenant accounts and onboards child tenant account users.


  • All child tenant accounts must be created as new.

  • You cannot convert an Megaport existing customer account to a Megaport ONE child tenant account, and a child tenant account cannot be converted to a Megaport direct customer account.

To create a child tenant account

  1. Log in to a root tenant account with Company Admin privileges.
  2. Click the Company Name in the upper-left corner.

  3. Click Create Child Tenant.

    Create Child Tenant

  4. Provide these details:

    • Child Tenant Name – Specify a unique name for the account that is easily identifiable, particularly if you plan on having more than one account. The description length is from 1 to 128 characters. To keep the company name anonymous, enter an alias name.
    • Child Tenant Account UID – Enter the child tenant account UID. The root tenant assigns a unique UID to each child tenant account. The UID length is from 1 to 128 characters. The UID is typically an identifier used in root tenant systems (for example, CRM or billing). The UID is shown on the invoices under Your Reference. The UID also identifies the account in email notifications.
  5. Click Create Tenant.
    You can create as many child tenant accounts as you like.
    The accounts appear on the Tenants page. List of Child Tenants You can search for a child tenant by name.

  6. Click the child tenant and confirm the switch from a root tenant to a child tenant to view the child account dashboard and all configured account services, such as Ports. For details, see The Dashboard.


    To change the account name or UID after the child tenant account has been created, a root tenant user needs to change to the child tenant account then navigate to Settings > General and edit the Tenant Name and Account Ref (UID) fields.


When a Company Admin creates a child tenant account, it is configured without any settings by default and instead inherits its configuration from the root tenant default settings. For default settings, see What Tenants Can View and Access.

Next steps

Now that you’ve created a child tenant account, the next steps are to add users and order services, such as Ports, Virtual Cross Connects (VXCs), Megaport Virtual Edges (MVEs), and so on.

Last update: 2023-05-23