# 1. Create Users & Tenants

## Create Users & Tenants

In this chapter, you'll learn the onboarding flow for ABB Ability BuildingPro and BuildingPro Suites.

The process starts in [ABB Ability BuildingPro](https://buildings.ability.abb/), where users sign up or log in with SSO, create portfolios, and invite additional users. Each portfolio is synchronized to BuildingPro Suites as a tenant.

This means:

* portfolios in ABB Ability BuildingPro become tenants in BuildingPro Suites
* invited users are synchronized to BuildingPro Suites automatically
* roles can then be created and adjusted inside BuildingPro Suites

To manage collaboration in BuildingPro Suites, **roles** determine what permissions users have within a tenant.

## Recommended order for the first setup

1. Select the portfolio assigned to you, or create a new one.
2. Open BuildingPro Suites from that portfolio.
3. Check the license and access status.
4. Invite the first users.
5. Create or adjust roles if needed.

#### How to get started with the configuration of your environment:

* Log in and open BuildingPro Suites: Use the selected portfolio as the entry point into the correct tenant context.

{% content-ref url="/pages/nMsoaRx9nuxzsNTOn1wk" %}
[Log In and Open BuildingPro Suites](/collection/getting-started/1.-create-users-and-tenants/log-in-and-open-buildingpro-suites.md)
{% endcontent-ref %}

* Create a tenant: Create a portfolio in ABB Ability BuildingPro. This automatically creates the corresponding tenant in BuildingPro Suites.

{% content-ref url="/pages/yv4ZBdKSDCCUfPKlPPBD" %}
[Create a Tenant](/collection/getting-started/1.-create-users-and-tenants/create-a-tenant.md)
{% endcontent-ref %}

* Check license and access status: Confirm that the selected portfolio can be used in BuildingPro Suites and review expiry warnings if shown.

{% content-ref url="/pages/v8OcXrKCdcKkkQ85xpkZ" %}
[Check License and Access Status](/collection/getting-started/1.-create-users-and-tenants/check-license-and-access-status.md)
{% endcontent-ref %}

* Invite users to a tenant: Invite users from the Portfolio Editor so their accounts are created and synchronized automatically.

{% content-ref url="/pages/z3SCnhFXvZJJzKak6LwC" %}
[Invite Users to a Tenant](/collection/getting-started/1.-create-users-and-tenants/create-a-user.md)
{% endcontent-ref %}

* Create a role: Create additional roles inside BuildingPro Suites after entering it from the sidebar.

{% content-ref url="/pages/9ng65fbqwaTQXfWIWIOV" %}
[Create a Role](/collection/getting-started/1.-create-users-and-tenants/create-a-role.md)
{% endcontent-ref %}

* Assign a role to a user: Adjust the role of a synchronized user inside BuildingPro Suites.

{% content-ref url="/pages/WBICSrAVx4SNCRgcrUsS" %}
[Assign a Role to a User](/collection/getting-started/1.-create-users-and-tenants/assign-a-role-to-a-user.md)
{% endcontent-ref %}

Each of these steps is essential for a successful start. Follow them in this order to prepare the portfolio, confirm access to BuildingPro Suites, and onboard your first users.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/getting-started/1.-create-users-and-tenants.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.