Fortum

A connected Fortum customer account, reporting your own electricity consumption as read-only sensors - logged in with the same Oma Fortum username and password you already use on Fortum's own website or app.

Connecting

Devices & Services > Fortum > "+ Add account" asks for your Oma Fortum username and password directly - there's no OAuth consent screen or app credentials to create, since Fortum has no public API for this; Athena logs in the same way the website itself does.

Entities

Four read-only sensors, in kWh: today_consumption, yesterday_consumption, month_consumption, and daily_consumption (today's own total again, but the one sensor "Backfill history" below writes historical rows against, so a Chart or Statistics card following it shows a continuous series instead of only what's accumulated since the account was connected). Consumption is metered and reported at most a few times a day, so a background loop checks for new numbers every 3 hours rather than polling constantly. Works with Dashboard cards, History, and Automations exactly like every other integration - there's nothing to control, so it never appears as an Action node target, only as a state source.

Backfill history

The account's own Consumption card menu has a "Backfill history" action - pick a start date (up to 365 days back) and Athena fetches your daily consumption straight from Fortum for that whole range in one request, adding it as history for daily_consumption. Days already covered by existing history are skipped automatically, so running it again (or extending the range later) never double-counts a day.

Newer and less proven than most of Athena's other integrations. This isn't a public, documented Fortum API - it's a real (if unofficial) login flow reverse-engineered against Fortum's own Finnish site. Unlike some of Athena's other login-based integrations, there was no ready-made reference to follow here: the one community project found for Fortum only ever covered the Swedish site, which turned out to use a meaningfully different (and simpler) login flow than the Finnish one actually needs. The Finnish flow was reconstructed by directly testing the real endpoints, but the very last steps (submitting a password and completing login) couldn't be fully verified without a real account. If adding an account fails, or gives an unclear error, check Athena's own logs (the fortumapi component) for the real underlying error and report back what you find.