Energy connectors (older ingest path)

Energy connectors are the older way to push readings straight into energy meters. They keep working for existing setups, but for any new meter or sensor use FreeMaint Connect: devices are recognised automatically, their health is monitored, alerts can open work orders, and a channel can still feed an energy meter.

Pairing a connector

Pair a connector to generate an API key. The key is shown only once, so copy it immediately and store it securely — you can rotate it later if needed.

Ingesting readings

Point your gateway at FreeMaint to push readings in automatically.

• Have your gateway POST readings to /api/v1/energy/ingest using the API key as a Bearer token.
• Map each physical meter to a FreeMaint meter using its external ID, so every reading lands on the right meter.

Control over connectors

To send commands back to your equipment, register the connector's command endpoint (an HTTPS URL). FreeMaint then sends signed commands to that endpoint, so the connector can trust and execute them.

Status and key rotation

Each connector card shows its current connection status. You can rotate the API key at any time — useful if a key may have been exposed or as part of routine security hygiene.