Skip to main content
A connection is an individual utility meter point — an electricity NMI, a gas MIRN, or a water meter reference. This guide walks you through creating a connection and wiring it into the rest of your data: a site, its meters and reads, and a retail account. For the list view and column reference, see Connections.

Creating a connection

1

Open the create drawer

Navigate to the Connections page from the sidebar. On the Connections tab, click the + button in the top-right corner to open the Create New Connection drawer.
The Create Connection drawer with the identifier, utility, and namespace fields
2

Enter the identifier and key fields

Fill in the Connection Information section:
  • Identifier (required) — The meter point identifier: the NMI for electricity, the MIRN for gas, or the meter reference for water.
  • Connection Address — The physical address or location of the connection.
  • Utility (required) — Select the utility type (Electricity, Natural Gas, or Water). This drives the consumption units and charting.
  • Namespace (required) — The identifier market or namespace (for example, AU_DEFAULT for Australian connections).
Optionally expand the other sections:
  • Loss FactorsDistribution Loss Factor and Marginal Loss Factor groups (electricity).
  • Annual UsageAnnual Utility Cost, Annual Utility Consumption, and the consumption Quantity unit.
  • DatesDate Established and Date Abolished.
3

Save

Click Save to create the connection. You are taken to its detail page, headed by the identifier, where the remaining steps take place.
Use the right identifier for the utility: a NMI (National Meter Identifier) for electricity, a MIRN (Meter Installation Reference Number) for gas, and the meter reference for water. The create drawer does not ask for a site — you link the connection to a site as a separate step below.

Linking, metering, and retail accounts

From the connection detail page, the header actions handle the remaining relationships.
1

Link the connection to a site

Click Add to Site (the primary header action) to open the Add Connection to Site drawer, choose the site, and save. Once linked, the connection’s location appears on the Overview map. You can also allocate the site from the Settings tab.
2

Add meters and registers

Click New Meter to add a physical meter to the connection. Each meter has one or more registers (measurement channels) that record the time-series reads. See Meters, Registers & Reads for the full metering hierarchy.
3

Attach a retail account

Click New Retail Account to record the retailer’s account reference for this connection. Retail accounts are how incoming invoices get matched to the correct connection — see Retail Accounts.
A connection detail page Overview tab with stats and connection details
Electricity, gas, and water connections are managed the same way, but their consumption units differ — kWh for electricity, MJ for gas, kL for water. The Utility you select on creation sets these automatically.

Connection detail tabs

The detail page organises everything about a connection into tabs:
TabWhat it’s for
OverviewStatus, utility type, annual consumption and spend, a consumption chart, and the location map
Site ConnectionsThe site links for this connection
MetersThe physical meters installed at the connection — see Meters
InvoicesInvoices billed against this connection
ReadsAggregated time-series consumption reads, with charting and CSV export
Retail AccountsThe retailer account references attached to this connection
AgreementsThe energy agreements covering this connection
Quantity ConstantsConversion constants applied to this connection’s quantities
SettingsEdit connection details and allocate the site
The Meters tab is the entry point into the metering hierarchy — meters, their registers, and the reads beneath them. See Meters, Registers & Reads for how that structure fits together.