Skip to main content

​
Set Up a New User

Now that we have an access token, we will call the Podero API user endpoint to create a new user.

​
Create a User

To create a new user, make a POST request with your organization ID and access token: 
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]"
  }'
This provides the minimum amount of data needed to create a new user. In this case, we are creating an end-user, meaning they only have access to their own resources.

​
User Roles

Standard end-user role. Users only have access to their own resources (buildings, devices).Use this role for your customers.
Staff users can view and manage all users and devices but cannot manage admin users.Use this role for support team members.
Admin users have full access to all organization resources and can manage other admins and staff.Use this role for administrators within your organization.
Please reach out to your account manager if you have not received an Organization ID (org_id) yet.

​
Response

If the correct values were provided, you should receive a successful response: 
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "external_user_id": null,
  "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
}
​
id
string (UUID)
required
The user_id value is a unique string that identifies your new user. Save this for subsequent requests.
​
external_user_id
string
Optional field where you can store your internal user ID for cross-referencing.
​
role
string
required
The role assigned to this user (user, staff, or admin).
​
email
string
required
The user’s email address.

​
Next Step

Add Building

Update user information and add a building