Skip to main content

​
Connect a Heat Pump

Create an onboarding session and redirect your user to Connect UI to add their device: 
curl -X POST \
  'https://app.podero.com/api/partners/v2.0/device-onboarding' \
  -H 'Authorization: Bearer {auth_token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "language": "en",
    "price_zone_default": "DE",
    "success_url": "https://yourapp.com/success",
    "cancel_url": "https://yourapp.com/cancel",
    "user_id": "{user_id}",
    "building_id": "{building_id}"
  }'
What happens next:
  1. User is redirected to Connect UI
  2. User selects their device manufacturer
  3. User authenticates with manufacturer credentials
  4. Device is connected and linked to their account
  5. User is redirected back to your success_url with ?deviceId={device_id}
For testing, use demo credentials: [email protected] / Demo1234
Need more details? See Device Onboarding for complete workflow, screenshots, best practices, and error handling.

Next: Retrieve Device Data

Read data from your connected device