Integrations: Overview
An integration is a push-based delivery target: as soon as new readings arrive, energiedaten.at sends them to the system you have configured. You do not need to poll for data.
The model has two layers:
- Connection: The delivery target (a URL, an MQTT broker, or an email address). One connection can receive data from multiple meters.
- Route: The assignment of a meter to a connection. A meter can route to multiple connections at the same time.
Integration types
| Type | Description | Available from |
|---|---|---|
| Webhook | JSON push to a URL when new data arrives | Light |
| MQTT | Pub/Sub messaging for IoT platforms | Plus |
| Email (CSV) | Scheduled CSV delivery by email | Light |
| SFTP | Scheduled CSV upload to a server | Pro |
Routes per meter
A connection can receive data from any number of meters, and the number of connections itself is not limited. What is limited is how many connections a single meter routes to at once; that depends on the plan.
| Plan | Routes per meter |
|---|---|
| Community | 0 (API access only) |
| Light | 1 |
| Plus | 2 |
| Pro | 5 |
Deactivation on delivery failure
If a delivery fails 5 times in a row, the connection is deactivated and you receive a notification. No further delivery attempts are made until you have checked and reactivated the connection. History and error details are available under Delivery Logs & Errors.
Connect a specific tool
Ready-made guides are available for common tools:
| Tool | For whom | Integration type | Minimum plan |
|---|---|---|---|
| Home Assistant | Smart home users, developers | HACS integration (API) | Community (free) |
| ThingsBoard | Energy service providers, facility managers | MQTT | Plus |
| EnerChart | Energy consultants, property managers | MQTT or Email (CSV) | Light (CSV) / Plus (MQTT) |
Direct API access
If you build your own applications or want to connect a tool not listed here, use the REST API directly:
- API Quickstart: from token to first data point in 5 minutes.
- API Reference: complete endpoint documentation.
Integrations vs. reports
Integrations keep an external system supplied with meter data as it arrives. A report is different: it creates a CSV summary of one closed period and sends it by email, once, on demand, or on a schedule. If you need a snapshot for filing or forwarding, a report is the right tool.