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}'

response = requests.get(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users',
    headers={
        'accept': 'application/json',
        'Authorization': f'Bearer {auth_token}'
    }
)

users = response.json()

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"
  }'

response = requests.post(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users',
    headers={
        'accept': 'application/json',
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {auth_token}'
    },
    json={
        'role': 'user',
        'email': '[email protected]',
        'external_user_id': 'customer_12345',
        'first_name': 'John',
        'last_name': 'Doe'
    }
)

new_user = response.json()
user_id = new_user['id']

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": "DE"
  }'

response = requests.put(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}',
    headers={
        'accept': 'application/json',
        'Content-Type': 'application/json',
        'Authorization': f'Bearer {auth_token}'
    },
    json={
        'first_name': 'Peter',
        'last_name': 'Schmidt',
        'street_and_number': 'Main Street 123',
        'zip_code': '10115',
        'town': 'Berlin',
        'country': 'DE'
    }
)

updated_user = response.json()

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}'

response = requests.get(
    f'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}',
    headers={
        'accept': 'application/json',
        'Authorization': f'Bearer {auth_token}'
    }
)

user = response.json()

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}'

curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/electric-vehicles' \
  -H 'Authorization: Bearer {auth_token}'

curl -X GET \
  'https://app.podero.com/api/partners/v2.0/org/{org_id}/users/{user_id}/inverters' \
  -H 'Authorization: Bearer {auth_token}'

Best Practices

Data Management

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

Support Operations

Create support tickets linked to user_id
Log all API operations for audit trails
Implement alerts for device disconnections
Provide self-service reconnection options

Security

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

Device Not Connecting
Optimization Not Working
User Migration

Steps:

Check is_authenticated status in device response
If false, check the actions array for an entry with a resolution_link
Redirect the user to the resolution_link URL to reconnect their device
Verify is_authenticated returns true after the user completes the flow

Steps:

Verify is_smart_optimization_active is true
Check device authentication status
Review temperature/charge limits are set correctly
Ensure energy contract data is up-to-date

Steps:

Create new user in Podero
Update external_user_id with old system ID
Migrate all devices
Verify data integrity
Archive old user record (if needed)

Overview

Getting Started

End-User Workflows

Back-Office Workflows

Notifications

API Reference

Heat Pumps

Electric Vehicles

Solar Inverters

User Management

Partner Back-Office: User Management

List All Users

Create New User

Update User Data

Get User Details

Get User’s Devices

Best Practices

Common Support Scenarios

Next Steps

Team Administration

User Parameters

​Partner Back-Office: User Management

​List All Users

​Create New User

​Update User Data

​Get User Details

​Get User’s Devices

​Best Practices

​Common Support Scenarios

​Next Steps

Team Administration

User Parameters

Partner Back-Office: User Management

List All Users

Create New User

Update User Data

Get User Details

Get User’s Devices

Best Practices

Common Support Scenarios

Next Steps