home-assistant.io/source/_integrations/powerfox.markdown

title, description, ha_category, ha_release, ha_iot_class, ha_config_flow, ha_codeowners, ha_domain, ha_platforms, ha_integration_type, ha_quality_scale, ha_zeroconf

title	description	ha_category	ha_release	ha_iot_class	ha_config_flow	ha_codeowners	ha_domain	ha_platforms	ha_integration_type	ha_quality_scale	ha_zeroconf
Powerfox	Instructions on how to integrate Powerfox within Home Assistant.	Energy Sensor	2025.1	Cloud Polling	true	@klaasnicolaas	powerfox	diagnostics sensor	integration	silver	true

The Powerfox {% term integration %} allows you to gather data from your Poweropti devices, by using their cloud API and fetching the data in Home Assistant.

Powerfox is a German company that provides smart meters (Poweropti) for reading electricity, water, gas, and heat. They have their own cloud platform where you can monitor the usage of your devices and get insights into your energy consumption.

{% include integrations/config_flow.md %}

Configuration parameters

{% configuration_basic %} Email: description: The email address of your Powerfox account. Password: description: The password of your Powerfox account. {% endconfiguration_basic %}

Poweropti devices

Not all Poweropti devices are supported currently. Check the list below to see if your device is working with this integration. Create a feature request if your device is not supported yet.

Device	Type	Supported
PA 201901 / PA 201902	Power meter	Yes
PB 202001	Power meter	Yes
WA 201902	Water meter	Yes
Powerfox FLOW	Gas meter	No
HA 201902	Heat meter	Yes

Data updates

The integration will update its information by polling Powerfox every 10 seconds. This ensures the data in Home Assistant is up to date.

Actions

This integration does not provide additional actions.

Examples

Get alerted when power usage spikes

Use this automation to keep an eye on sudden peaks in your electricity usage. When the Powerfox sensor reports more than 4 kW for two minutes, Home Assistant sends a notification so you can react quickly (for example by switching off large loads).

{% details "Example YAML automation" %} {% raw %}

alias: "Powerfox high usage alert"
description: "Notify me when the Powerfox meter reports sustained high power draw."
triggers:
  - trigger: numeric_state
    entity_id: sensor.poweropti_power
    above: 4000
    for:
      minutes: 2
actions:
  - action: notify.mobile_app_phone
    data:
      title: "High consumption detected"
      message: "Powerfox currently reports {{ states('sensor.poweropti_power') }} W."

{% endraw %} {% enddetails %}

Replace the threshold value, and the notify target with the entities that exist in your installation.

Supported functionality

The Powerfox platform mainly provides sensors that you can use in your energy dashboard.

Power meter

It will create the following sensors:

• Power (W): Active power that is measured.
• Energy usage (kWh): How much energy is used since the installation.
• Energy usage - low tariff (kWh): Energy usage on the low tariff.
• Energy usage - high tariff (kWh): Energy usage on the high tariff.
• Energy returned (kWh): Energy returned to the grid.

{% note %} The energy tariff sensors are only available if your Poweropti device supports it. {% endnote %}

Water meter

It will create the following sensors:

• Cold water (m³): How much cold water is used.
• Warm water (m³): How much warm water is used.

Heat meter

It will create the following sensors:

• Total energy (kWh): How much energy is used.
• Delta energy (kWh): How much energy is used since the last update.
• Total volume (m³): How much water is used.
• Delta volume (m³): How much water is used since the last update.

Troubleshooting

{% details "Cost sensors stay at zero" %}

Powerfox only publishes currency fields when a tariffs are configured in their app. Set the tariff inside the Powerfox app, then wait for the next report; the Home Assistant sensors will populate once the API exposes those fields. {% enddetails %}

Removing the integration

This integration follows standard integration removal. No extra steps are required.

{% include integrations/remove_device_service.md %}