Skip to main content
This guide sets up your organisation by hand, one record at a time. It’s useful for learning how the pieces fit together, or for small additions. If your organisation already has data, skip to the sections you need.
Setting up a whole portfolio? Guided onboarding is faster. Upload documents for Joule to read, or load everything from one file, then review and create it all at once.
Choosing a plan is optional during sign-up. If you clicked Skip for now — set up billing later, an organisation admin can subscribe at any time from Settings › Plan & billing. See Plan & billing.
Each create button opens a drawer on the right. Fill in the fields and click Save.

Step 1: Create your accounts

Accounts are the top-level containers, typically one per customer or business entity.
1

Open Accounts

Select Accounts in the sidebar.
2

Add an account

Click Add account.
3

Enter the details

Enter the account name (required). You can also set the entity type, tax ID (ABN or ACN) and a parent account.
4

Save

Click Save.
For a business with subsidiaries, create the parent account first, then set it as the parent on each child account.
See Creating Accounts for more.

Step 2: Add sites

Sites are the physical locations where energy is used: offices, warehouses, stores, factories.
1

Open Sites

Select Accounts in the sidebar, then the Sites tab.
2

Add a site

Click New Site to open the Create New Site drawer.
3

Enter the details

Enter the site name, choose its account (both required) and enter the address.
4

Save

Click Save.

Step 3: Set up connections

Connections are individual utility meter points: electricity NMIs, gas MIRNs or water meters.
1

Open Connections

Select Connections in the sidebar.
2

Add a connection

Click New Connection to open the Create New Connection drawer.
3

Enter the details

Enter the connection identifier (for example the NMI or MIRN) and its utility.
4

Save

Click Save.
5

Link it to a site

The drawer doesn’t ask for a site. On the connection’s page, click Add to Site.
See Managing Connections for more.

Step 4: Create agreements

Agreements track energy contracts between your accounts and suppliers.
1

Open Agreements

Select Agreements in the sidebar.
2

Add an agreement

Click Add agreement to open the Create New Agreement drawer.
3

Enter the details

Enter the agreement name and type (both required), then the account, supplier and contract dates.
4

Save

Click Save.
5

Add connections

On the agreement’s page, add connections on the Connections tab.
See Managing Agreements for bulk-adding connections and managing tariffs.

Step 5: Upload your first invoice

1

Open Uploads

Select Invoices in the sidebar, then the Uploads tab.
2

Add your files

Click Upload invoices (the upload icon in the header), then drag invoice files onto the drop area or click it to choose them.
3

Let UtiliRead process them

UtiliRead extracts each invoice and matches it to the right account and connection. Follow progress in the upload queue.
4

Check the result

Open the invoice to check the extracted data.
You can also have retailers email invoices to your UMS inbox so they’re processed automatically. See Inbox.

What to do next

Set up tariff rates

Configure tariffs for your agreements so UMS can check invoice charges against expected rates. See Managing Tariffs.

Check invoice validation

Open Invoices › Validations to find billing errors and tariff mismatches. See Working the validation queue.

Run an agreement expiry report

Open Reports and run the Agreement Connections Expiry and Billing Report to find contracts nearing renewal, so you can start renegotiating early.

Configure brokerage (if applicable)

If you earn commission on energy agreements, set up brokerage. See Brokerage revenue and invoicing.

Bulk import from CSV

For large portfolios, import accounts, sites, connections, tariffs and more from CSV. Open the account menu (your name at the bottom of the sidebar), select Bulk Imports, then click New Import to open the Bulk upload wizard. Bulk Imports only appears for organisation admins. To create a whole hierarchy from one file, use the all-in-one onboarding upload. See Bulk Importing Data.

Invite your team

Add colleagues and control what each of them can access. See Setting Up a User.

Subscribe to a plan

If you skipped the plan step, subscribe from Settings › Plan & billing at any time. See Plan & billing.