Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developers.podero.com/llms.txt

Use this file to discover all available pages before exploring further.

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