Skip to main content

​
Partner Back-Office: User Management

Running a complex energy optimization over large device fleets requires good tooling. Our utility back-office web app is designed to help Partners manage the connected fleet of their end-users’ devices, provide customer support, and coordinate within their team.
Administrative functions like Partner user account management are largely done via the Podero utility back-office web app.

​
List All Users

Get a dashboard overview of all users in your organization: 
curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {auth_token}'

​
Create New User

Add a new end-user to your organization: 
curl -X POST \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {auth_token}' \
  -d '{
    "role": "user",
    "email": "[email protected]",
    "external_user_id": "customer_12345",
    "first_name": "John",
    "last_name": "Doe"
  }'
Use the external_user_id field to link Podero users with your internal customer IDs.

​
Update User Data

Modify existing user information: 
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 '{
    "first_name": "Peter",
    "last_name": "Schmidt",
    "street_and_number": "Main Street 123",
    "zip_code": "10115",
    "town": "Berlin",
    "country_iso2": "DE"
  }'

​
Get User Details

Retrieve complete information for a specific user: 
curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer {auth_token}'

​
Get User’s Devices

Retrieve all devices associated with a user: 
curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/heat-pumps' \
  -H 'Authorization: Bearer {auth_token}'

​
Best Practices

  • Regularly sync external_user_id with your internal systems
  • Maintain up-to-date contact information for support
  • Use consistent location data for accurate optimization
  • Archive or flag inactive users appropriately
  • Create support tickets linked to user_id
  • Log all API operations for audit trails
  • Implement alerts for device disconnections
  • Provide self-service reconnection options
  • Restrict user management to authorized staff only
  • Log all user data modifications
  • Implement role-based access control
  • Never expose user credentials or sensitive data

​
Common Support Scenarios

Steps:
  1. Check is_authenticated status in device response
  2. Look for authorization_url field
  3. Send reconnection URL to user
  4. Verify connection after user completes flow

​
Next Steps

Team Administration

Manage staff and admin users

User Parameters

Complete user parameter reference