User management

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

SOAP

Methods

• user_create_e to create or add a new or existing user to a company
• user_list to list company users
• user_show to show information about a specific user
• user_update_e to update users details. Note that user’s email address cannot be updated through the API
• user_delete to delete a user from a company account. You cannot delete your own user account

REST

Endpoints

• 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)