Creating a new company

This article walks you through creating a new company (tenant) in MobilityManager, including the required details and what the platform sets up automatically. Creating companies is an administrator task.

Who can create a company

Creating a company requires the tenants:create permission, which is normally held by a SystemAdmin. If your role does not include this permission, the create action is not available to you.

Note: The number of companies you can create is capped by your license. If the limit is reached, creation fails with a message that the tenant limit has been reached. Contact your license administrator to raise the cap.

Information you need

Before you start, decide on two required values:

• Name — the organization's display name (up to 200 characters).
• Code — a short unique identifier (up to 100 characters) that users will select at sign-in. The code must not already be in use by another company.

Choosing where the company's data lives

Every company stores its fleet data in its own database. When you create a company you choose how that database is provided:

1. Auto-create the database — the platform provisions a new database for you. It generates the next available name using the template mobilitymanager001 through mobilitymanager999, builds the connection based on the system database configuration, and applies the schema automatically.
2. Provide a connection string — if you have already prepared a database, supply its connection string and the platform will use it instead.

Tip: Auto-create is the simplest option for most new companies. Only supply your own connection string if your organization manages databases separately.

Steps to create a company

1. Open the company (tenant) management area.
2. Start a new company and enter the Name and Code.
3. Select either auto-create database or provide a connection string.
4. Confirm. The platform validates that the name and code are present and that the code is unique, then creates the company.

On success you receive the new company's identifier, its database name, and the connection that was configured.

Defaults applied automatically

A newly created company starts with sensible defaults that you can change later in its settings:

Warning: If the database could not be created during auto-provisioning, the company is still created but its database will be unreachable. Check the company's health status and resolve the database issue before assigning users.

Next steps

1. Review and adjust the company's settings (language, currency, regulatory framework, booking and approval rules).
2. Add users and assign them a role in the new company.
3. Confirm the company's database status shows as healthy.

Related

• Company codes and identifiers explained
• How each company's database works
• Activating and deactivating a company
• Giving a user access to multiple companies