Users
User Account Deletion Policy
To maintain system security and efficiency user accounts (including API users for integrations) that meet the following conditions will be automatically deleted: Users who haven’t logged in for a year and have been removed from their last company over six months ago.
User creation
Users are created to Maventa based on an email address. Creation happens at the time of the company account opening, or separately over API or user interface. A user can be connected to many companies and a company can have many users.
Created company user can be real person or an api-user that is a technical user only. Same api-user can be added to multiple accounts, but usually for integrators with larger amount of customers it is for security reasons recommended to have own api-user per account. For example email could be formatted as maventauser+companyBID@example_domain.com.
Access to Maventa web user interface requires access to user email for authentication. If the new users will log in to UI make sure they have access to their email address.
User roles and rights
You can control the user rights by changing the user role. There are two roles, user and admin user. Compared to admin, users have more limited rights to service, they cannot for example modify company details or settings or add new users to the company.
User settings
You can configure user specific setting in Maventa, e.g. notifications which user would like to get.
API methods for user management
- POST/v1/users to create API user (technical user)
- POST/v1/company/users to add a new or existing user to a company (UI user)