Create User
POST/createUser
This API onboard or create a new user.
The Authorization
must have Bearer
followed by Token
.
Optional Parameters:
validateagainstpolicy
- Values: Y/N, default is Y. Checks for the password policy,
statuskey
- Values:1/0, 0 - Inactive, 1 - Active (default),
allowpastdate
- true / false (default). If true, allows startdate to be less than current date,
User params
like
username,
firstname,
preferedFirstName,
lastname,
middlename,
street,
city,
comments,
statuskey,
startdate(MM-dd-yyyy),
enddate(MM-dd-yyyy),
manager (manager username),
password,
location,
jobCode,
jobDescription,
employeeType,
departmentNumber,
title,
state,
companyname,
costcenter,
departmentname,
employeeclass,
entity,
jobcodedesc,
locationdesc,
locationnumber,
siteid,
orgunitid,
region,
regioncode,
owner,
employeeid,
lastsyncdate,
createdate,
email,
phonenumber,
job_function,
country,
displayname,
enabled(can be "1"/"true" or "0"/"false"),
passwordExpired(can be "1"/"true" or "0"/"false"),
accountExpired(can be "1"/"true" or "0"/"false"),
accountLocked(can be "1"/"true" or "0"/"false"),
secondaryManager,
createdBy,
termDate,
vendorManager,
secondaryPhone,
secondaryEmail,
customproperty<1-50>,
hcp<1-5>,
ecp<1-5>,
customer(pass the organization name),
securityQuestions
-
Example:
"securityQuestions":[
{
"securityQuestion":"What is your first Pet's name?",
"securityAnswer":"kitty"
},
{
"securityQuestion":"What is your favorite food?",
"securityAnswer":"food"
}
],
checkrules
- true/ false (default : true), if true, then rules will be evaluated immediately, if false rules will be evaluated by a job. If checkrulesforapi configuration(true/false/null) is set in the configuration table, then it will take precendence over checkrules parameter.
inlineruleevaluation
- true/ false (default is true), if true then rules will be evaluated immediately, if false rules will be evaluated by a job.
Note - CreateUser API will not invoke workflow based on the User Modification Workflow configuration. Please use createUserRequest API instead.
Note - Both checkrules
and inlineruleevaluation
need to be set as true for the user update rules to be evaluated immediately.
batchidentifier
- When inlineruleevaluation=false, this Rule Run Unique Identifier can be set and user update rules can be processed later by calling /api/processrules API
It's highly recommended to pass inlineruleevaluation:"false" for bulk load and call processrules api to evaluate and run the rules after the load is done.
Request
- application/json
Body
Responses
- 200
Create User
Response Headers
Date
string
Server
string
Set-Cookie
string
Transfer-Encoding
string
X-Frame-Options
string
- application/json
- Schema
- Example (from schema)
- Create User
Schema
{
"errorCode": "0",
"message": " Users created with username johndoe "
}
{
"errorCode": "0",
"message": " Users created with username johndoe "
}