Modbus TCP needs to be activated on the meter. Die IP of the meter needs to be added into the template
Will be removed after November 2026 (until v.1.0.2)
In the template, in front of the URL of the API call, the username and password needs to be added. The username has to be set by smart-me.
since version 1.0.3 available from 28.7.2025.
First create an API key in the smart-me portal:
[API] -> [ApiKeys] -> [Create new]
Add Name and set needed claims
You can find the required claims (permissions) here: Documentation API
For the template, "device.readswitch" is enough
Configuring virtual Output Command:
The ApiKey: (for example) n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu has to be added in the loxone template.
Get DeviceID:
The deviceID can be grabbed through systemhealth. Alternativly it can be grabbed through the API.
Example with the same API-Key:
curl -X "GET" "https://api.smart-me.com/Devices" -H "accept: */*" -H "Authorization: ApiKey n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu"
Configuring virtual Output Command:
The deviceID has to be added in the loxone template.
Configuring virtual Input:
The ApiKey: (for example) n9CUnYCGmTOQZCCX1iHRqrF5Erzx9pUu has to be added in the loxone template.
In addition, the IP and Access data of the Loxone Miniserver must be stored in the virtual input.
Reason: The virtual input from loxone does not offer the option of adjusting the HTTP request header, whereas the output does. This means that it must be adjusted so that the response to the request is stored on the Miniserver and read out with the virtual input.
Create an API key in the Smart-me portal with the claims: device.readwrite and user.readwrite
Execute the following call (edit the fields before it (ApiKey & Name))
curl -i -X 'POST' 'https://api.smart-me.com/Devices' -H 'accept: text/plain' -H 'Authorization: ApiKey <apikey>' -H 'Content-Type: application/json-patch+json' -d '{"activePower": 0, "counterReading": 0, "counterReadingExport": 0, "valueDate": "2025-07-08T08:15:55.026Z", "name": "Loxone Example", "deviceEnergyType": 1}'
Take the UUID of the meter from the response.
Alternative 1: Get the UUID from System Health in the dashboard.
Alternative 2: Use GET https://api.smart-me.com/Devices to obtain all IDs.
This data must be entered in the Loxone Library.
In summary, a virtual meter was created that can then be used in Loxone.