Development build — sample configuration

Bring in your first water utility

Register a water utility from the platform dashboard, review its application and hand the workspace over to the person who will run it.

This article is for the platform team, the people who run the service for many water utilities. On the platform Home, the Set up the platform card lists what is left to do, and Register the first utility is one of the steps. A utility can reach you in two ways: it signs up on its own, or you register it for it.

Before you start#

  • The utility's company name, as it should appear in the dashboard.
  • A short identifier for its workspace, in lowercase letters, digits and hyphens.
  • The email address or phone number of the person who will own the utility's account.
  • At least one plan defined, so the utility can be given a subscription. The Define plans step on the same card covers this.

Step 1: Register the utility#

  1. On Home, click Register the first utility, or open Organizations and click New company.
  2. On the Company step, fill in Company name, choose the Type and click Continue.
  3. On the Instance step, fill in Instance name and Identifier. The instance is the utility's own workspace. Click Continue.
  4. On Review, check the details and click Create company.
  5. When you see Company registered, click View company to open it, or Register another company.

Step 2: Follow the application#

  1. If the utility signed up on its own, it fills in its activation application itself. Open Applications to see it.
  2. Open the application and click Start review.
  3. Check each requirement and the attached documents. Ask for a correction where something is missing, or approve when everything is met.

Step 3: Hand the workspace over to its owner#

When the utility signs up on its own, the person who registers is already its Owner and nothing more is needed.

Inviting an owner from the platform dashboard is being added. The agreed flow is:

  1. You send an invitation to the owner's email or phone. They receive a one-time link.
  2. The owner opens the link, sets their own password and lands in the utility's workspace with the company details already filled in.
  3. If you set the workspace up for them first, the owner sees a summary of what was done and by whom, and must accept it. Only then do they get full access, and your temporary setup access ends.

Your team never signs in as the owner. Every step you take on the utility's behalf is recorded in its audit log.

What happens next#

The Register the first utility step counts as done only when the utility's owner has signed in to their own workspace. Registering the company or sending an invitation is not enough on its own. Next, give the utility a plan with Activate a subscription.

Common problems#

  • An instance with this identifier already exists. Choose a different identifier.
  • This company is already registered. Look for it in Organizations instead of creating it again.
  • The company was registered, but the instance was not created. Click Try again. The company is kept, so you only repeat the instance step.
  • Invalid identifier. Use only lowercase letters, digits and single hyphens.

Start today. Set up your utility in minutes.