Skip to main content

​
Add a Building

Next, we will update some information of the user and optionally add a building. Buildings are used to group devices at specific locations.

​
Update User Information

You can update user information by sending only the fields you want to change. You will need to specify the {user_id} of the user in the path. 
curl -X PUT \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {auth_token}' \
  -d '{
    "external_user_id": "12345abc"
  }'
You do not need to send the whole object - only the fields to be changed are necessary.

​
Response

If the correct values were provided, you should receive a successful response with the updated fields: 
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "external_user_id": "12345abc",
  "role": "user",
  "email": "[email protected]",
  "first_name": null,
  "last_name": null,
  "street_and_number": null,
  "street_add_info": null,
  "zip_code": null,
  "town": null,
  "country": null,
  "latitude": null,
  "longitude": null,
  "location_last_updated": null
}

​
Create a Building (Optional)

Buildings allow you to group devices at specific locations. This is useful when an end-user has multiple properties or locations. 
curl -X POST \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/buildings' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {auth_token}' \
  -d '{
    "name": "Main House"
  }'
Save the building_id from the response. You’ll use it to link devices to this building.

​
Why Use Buildings?

Buildings provide several benefits:
  • Organization: Group devices by physical location
  • Consumption Tracking: Separate consumption data by property
  • Billing: Associate user behavior to different metering points
  • Multi-Property Support: Manage users with multiple locations (e.g., main home and vacation house)

​
Next Step

Connect Heat Pump

Add your first device using the Connect UI