- 2 Minutes to read
- Print
- DarkLight
- PDF
Create Users and Groups (User Management)
- 2 Minutes to read
- Print
- DarkLight
- PDF
These APIs are provided in JSON format. They add users and user group mappings, and delete users.
This API creates users and groups. Returns nothing or error message.
POST /api/ui/user/saveUsersRaw
Content-Type: application/json
Accept: application/json
X-ACCESS-TOKEN: <Token>
Groups sent must be the final mapping because the previous mapping will be erased. If no groups are sent, the user will not be able to login to the tenant.
Unmapped groups will not be deleted.
Inactive users should be deleted before adding new users to avoid license limitations.
Required Fields (email, name, groups, role, password, userType):
Email: Must be a valid email format. Cannot be empty.
Name: Can be empty.
Groups: List of Group Objects {“name”:”group”}. Can be an empty list.
Role: "Admin" or "Power User", "Designer" or "Contributor User", or "Reviewer" or "Reviewer User". Cannot be empty.
Password: Must contain at least 1 uppercase, 1 lowercase, 1 number, and 1 special character. Minimum length 8 characters. Cannot be empty. Passwords will be set only for new users on the environment (users are global). If the user is already present on environment but not on the tenant, the password will not be reset/overridden.
userType: "External", "Business". Cannot be empty. User Types will define which users are internal to your business and which are external.
The Business user type is for all users within your organization that use Dynamic Planning, and have access only to your organization's tenant or tenant group.
The External user type is for users outside of your organization who need to access your application for diagnostics, development, or debugging work, such as Planful Support or Partner Consultants. External users have access to yours and other organizations' tenants.
Sample Payload
[
{
"email": "testuser1@test.com",
"name": "",
"status": "Unverified",
"groups": [
{
"name": "Group1"
}
],
"role": "Admin" or "Power User",
"password":"Test1234!"
"userType":"External"
},
{
"email": "testuser2@test.com",
"name": "",
"groups": [
{
"name": "Group1"
},
{
"name": "Group2"
}
],
"role": "Reviewer" or "Reviewer User",
"password":"Test1234!"
"userType": "Business"
}
]
Deletes users. Returns nothing or error message if user does not exist in the application (tenant).
POST /api/ui/user/deleteRaw
Content-Type: application/json
Accept: application/json
X-ACCESS-TOKEN: <Token>
Sample Payload
[
"testuser1@test.com",
"testuser2@test.com"
]