> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/getting-started/1.-create-users-and-tenants.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.