UiPath Automation Suite

The UiPath Automation Suite Guide

Creating or deleting organizations

An organization is the highest hierarchical level in Automation Suite after the host. Settings and entities (such as users, licenses, and others) for an organization are shared across the multiple tenants and services within that organization, but remain separate and isolated from other organizations, even those that belong to the same host.

You can create, or delete organizations from the Organizations page in the host portal:


Creating organizations

As a system administrator, you can create any new organizations needed within Automation Suite from the host portal.

When you create the organization, you define the name of the organization and appoint an organization administrator.
Each organization is managed by a distinct administrator user, called an organization administrator (Org. Admin). This user has the highest level of privileges, has access to all functional areas in Automation Suite at the organization level, and can perform all administrative actions strictly within and related to their organization.


Do I need a new organization or a new tenant?

Tenants allow you to create separation between multiple versions of the same UiPath service (or even to provision different combinations of services between tenants), keeping resources such as packages, roles, and available licenses separate. Tenants within the same organization share the same accounts, license pool (from the organization level), and organization settings.

Creating different organizations allows you to create strict separation between one another: different URL, different license pools, different accounts and roles, and different resources. One organization is unaware of and unrelated to another.

To create a new organization:

  1. Log in to the host portal as a system administrator.
    The Organizations page opens by default. Otherwise, open the Organizations page.
  2. In the top right, click Add Organization.
    The Add Organization panel opens at the right of the window.
  3. Fill in the Organization Name field.
    The name is used to generate an organization-specific site URL which can be used to access Automation Suite. The organization administrator can later edit this name, but it results in a change to the URL as well.
  4. Fill in the rest of the fields with the required details to create the organization administrator account.
    Depending on your Authentication Settings (Host > Users), the user might need to reset the password on first login.



Note the email address (or username) and the password you set for the organization administrator. You must provide this information to the organization administrator and you cannot recover it.

  1. Click Save to create the organization.
    The organization is now listed on the Organizations page.
    If email settings are configured in Global Settings, the new organization administrator also receives and email message at the provided email address, which requires that they confirm their email address.
  2. If you want to use host licensing, allocate licenses to the new organization. Otherwise, if the organization should supply their own license at the organization level, skip this step.
  3. Provide the organization name and credentials you set to the organization administrator so that they can log in and configure the organization.
    If you forgot to note this information, delete the organization and then recreate it.

Deleting an organization

If you delete an organization:

  • all data related to that organization is removed
  • the organization-specific URL is no longer reachable
  • any host licenses that were allocated to the organization return to the host license pool.

To delete an organization:

  1. Log in to the host portal as a system administrator.
    The Organizations page opens by default. Otherwise, open the Organizations page.
  2. Click at the right end of the row and select Delete organization.
    The Delete Organization confirmation dialog opens:
  1. Type the name of the organization, exactly as it appears, and then click Delete.
    A confirmation tooltip appears in the top right of the window informing you that the deletion is in progress.

It may take a few moments to delete the organization, after which it is removed from the list of organizations on the Organizations page.
All licenses that were previously allocated to the organization are returned to the host-level pool of licenses.

Updated about a year ago

Creating or deleting organizations

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.