---
title: Save User
slug: kron-pam-api-collection-340/save-user
docTags:
createdAt: 2024-07-12T13:38:00.272Z
---
{
"id": "jdPJF0pChiMC7QiSrAvUE",
"type": "api-oas-v2",
"data": {
"method": "POST",
"url": "{{url}}/aioc-rest-web/rest/user/saveUser",
"name": "",
"description": "Overview
\nThis method adds a new user to KRON PAM.
\nMandatory fields in request body:
\nParameters
\n\nname and surname: These fields are used to identify the user.eid: An alternative way to reference users. It's a unique identifier for each user.email: The email address of the user. It's essential for communication and might be used for notifications or password recovery.phoneNumber: Contact number of the user.groups: A list of groups to which the user belongs.\n\n- For example, a user can be part of \"DEFAULT_GROUP_SYSYEM_USERS\" and \"DEFAULT_GROUP_SYSYEM_ADMINS\". Or it can be a member of one of your founded User Groups like \"Linux_users\".
\n
\npassword: A required field for internal users. It's the password that the user will use to log in.passwordAlgorithm: The algorithm used to hash the password. In this case, \"MD5\" is used
",
"contentType": "application/json",
"request": {
"headerParameters": [
{
"name": "Content-Type",
"description": "",
"default": "application/json",
"value": "application/json",
"type": "string"
},
{
"name": "X-XSRF-TOKEN",
"description": "",
"default": "{{csrftoken}}",
"value": "{{csrftoken}}",
"type": "string"
}
],
"queryParameters": [],
"pathParameters": [
{
"name": "url",
"description": "",
"default": "url",
"value": "url",
"type": "string"
}
],
"bodyDataParameters": [
{
"name": "body",
"description": "",
"default": "{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"test@test.com\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}",
"value": "{\r\n\t\"internal\":true,\r\n\"personelId\":\"123123\",\"name\":\"test\",\"surname\":\"user\",\"eid\":\"testuser\",\"email\":\"test@test.com\",\"phoneNumber\":\"5550000000\",\"groups\":[\"DEFAULT_GROUP_SYSYEM_USERS\", \"DEFAULT_GROUP_SYSYEM_ADMINS\"], \"password\":\"admin\", \"passwordAlgorithm\":\"MD5\"\r\n}",
"type": "object"
}
],
"formDataParameters": [],
"oAuthParameters": []
},
"responses": [
{
"statusCode": "200",
"description": "Add User",
"jsonExample": "{\n \"id\": \"3c040987-adb7-45ab-9a50-264f04fbe13a\",\n \"eid\": \"testuser\",\n \"personelId\": \"123123\",\n \"name\": \"test\",\n \"passwordAlgorithm\": \"MD5\",\n \"password\": \"21232f297a57a5a743894a0e4a801fc3\",\n \"email\": \"test@test.com\",\n \"surname\": \"user\",\n \"internal\": true,\n \"properties\": {\n \"phoneNumber\": \"5550000000\",\n \"ubaThreshold\": \"50\"\n },\n \"groups\": [\n \"DEFAULT_GROUP_SYSYEM_ADMINS\",\n \"DEFAULT_GROUP_SYSYEM_USERS\"\n ],\n \"managerGroups\": null,\n \"lastLogin\": null,\n \"lastLoginIp\": null,\n \"recordLimit4Search\": null,\n \"passwordDirty\": false,\n \"passwordAutoGenerated\": false,\n \"phoneNumber\": \"5550000000\",\n \"forceChangePasswordOnNextLogin\": false,\n \"lockReason\": null,\n \"unlockOnPasswordChanged\": false,\n \"unlockTime\": null,\n \"tempUserEndTime\": null,\n \"tempUserStartTime\": null,\n \"tempUser\": false,\n \"externalDirectorySource\": null,\n \"userPropertyKey4Search\": null,\n \"userPropertyValue4Search\": null,\n \"locked\": false\n}"
}
],
"examples": {
"languages": [
{
"id": "RVguMuj0lWfi4eAIa-FOS",
"language": "curl",
"label": "cURL",
"code": "curl --request POST \\\n --url {{url}}/aioc-rest-web/rest/user/saveUser \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --header 'x-xsrf-token: {{csrftoken}}' \\\n --data-raw '\"{\\r\\n\\t\\\"internal\\\":true,\\r\\n\\\"personelId\\\":\\\"123123\\\",\\\"name\\\":\\\"test\\\",\\\"surname\\\":\\\"user\\\",\\\"eid\\\":\\\"testuser\\\",\\\"email\\\":\\\"test@test.com\\\",\\\"phoneNumber\\\":\\\"5550000000\\\",\\\"groups\\\":[\\\"DEFAULT_GROUP_SYSYEM_USERS\\\", \\\"DEFAULT_GROUP_SYSYEM_ADMINS\\\"], \\\"password\\\":\\\"admin\\\", \\\"passwordAlgorithm\\\":\\\"MD5\\\"\\r\\n}\"'"
},
{
"id": "VZ76pxVv0cjC37IWkVgep",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\nmyHeaders.append(\"x-xsrf-token\", \"{{csrftoken}}\");\n\nvar raw = JSON.stringify(\"{\\r\\n\\t\\\"internal\\\":true,\\r\\n\\\"personelId\\\":\\\"123123\\\",\\\"name\\\":\\\"test\\\",\\\"surname\\\":\\\"user\\\",\\\"eid\\\":\\\"testuser\\\",\\\"email\\\":\\\"test@test.com\\\",\\\"phoneNumber\\\":\\\"5550000000\\\",\\\"groups\\\":[\\\"DEFAULT_GROUP_SYSYEM_USERS\\\", \\\"DEFAULT_GROUP_SYSYEM_ADMINS\\\"], \\\"password\\\":\\\"admin\\\", \\\"passwordAlgorithm\\\":\\\"MD5\\\"\\r\\n}\");\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"{{url}}/aioc-rest-web/rest/user/saveUser\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "VOQqvJKnUQ4VeVDQbJuJp",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"{{url}}/aioc-rest-web/rest/user/saveUser\")\n\nhttp = Net::HTTP.new(url.host, url.port);\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest[\"x-xsrf-token\"] = \"{{csrftoken}}\"\nrequest.body = JSON.dump(\"{\\r\\n\\t\\\"internal\\\":true,\\r\\n\\\"personelId\\\":\\\"123123\\\",\\\"name\\\":\\\"test\\\",\\\"surname\\\":\\\"user\\\",\\\"eid\\\":\\\"testuser\\\",\\\"email\\\":\\\"test@test.com\\\",\\\"phoneNumber\\\":\\\"5550000000\\\",\\\"groups\\\":[\\\"DEFAULT_GROUP_SYSYEM_USERS\\\", \\\"DEFAULT_GROUP_SYSYEM_ADMINS\\\"], \\\"password\\\":\\\"admin\\\", \\\"passwordAlgorithm\\\":\\\"MD5\\\"\\r\\n}\")\n\nresponse = http.request(request)\nputs response.read_body\n"
},
{
"id": "4SV1WjmcMOnWrh_L0Ydm_",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"{{url}}/aioc-rest-web/rest/user/saveUser\"\n\npayload = json.dumps(\"{\\r\\n\\t\\\"internal\\\":true,\\r\\n\\\"personelId\\\":\\\"123123\\\",\\\"name\\\":\\\"test\\\",\\\"surname\\\":\\\"user\\\",\\\"eid\\\":\\\"testuser\\\",\\\"email\\\":\\\"test@test.com\\\",\\\"phoneNumber\\\":\\\"5550000000\\\",\\\"groups\\\":[\\\"DEFAULT_GROUP_SYSYEM_USERS\\\", \\\"DEFAULT_GROUP_SYSYEM_ADMINS\\\"], \\\"password\\\":\\\"admin\\\", \\\"passwordAlgorithm\\\":\\\"MD5\\\"\\r\\n}\")\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'x-xsrf-token': '{{csrftoken}}'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "RVguMuj0lWfi4eAIa-FOS"
},
"results": {
"languages": [
{
"id": "XU8kCbI4lxjEfiqKyUU7l",
"language": "200",
"code": "{\n \"id\": \"3c040987-adb7-45ab-9a50-264f04fbe13a\",\n \"eid\": \"testuser\",\n \"personelId\": \"123123\",\n \"name\": \"test\",\n \"passwordAlgorithm\": \"MD5\",\n \"password\": \"21232f297a57a5a743894a0e4a801fc3\",\n \"email\": \"test@test.com\",\n \"surname\": \"user\",\n \"internal\": true,\n \"properties\": {\n \"phoneNumber\": \"5550000000\",\n \"ubaThreshold\": \"50\"\n },\n \"groups\": [\n \"DEFAULT_GROUP_SYSYEM_ADMINS\",\n \"DEFAULT_GROUP_SYSYEM_USERS\"\n ],\n \"managerGroups\": null,\n \"lastLogin\": null,\n \"lastLoginIp\": null,\n \"recordLimit4Search\": null,\n \"passwordDirty\": false,\n \"passwordAutoGenerated\": false,\n \"phoneNumber\": \"5550000000\",\n \"forceChangePasswordOnNextLogin\": false,\n \"lockReason\": null,\n \"unlockOnPasswordChanged\": false,\n \"unlockTime\": null,\n \"tempUserEndTime\": null,\n \"tempUserStartTime\": null,\n \"tempUser\": false,\n \"externalDirectorySource\": null,\n \"userPropertyKey4Search\": null,\n \"userPropertyValue4Search\": null,\n \"locked\": false\n}"
}
],
"selectedLanguageId": "XU8kCbI4lxjEfiqKyUU7l"
}
},
"children": [
{
"text": ""
}
]
}