Add User

General Information

Service	API	Method

Service	API	Method
urac	/admin/addUser	POST

Data Models: Users, Tokens

WorkFlow: Add User Flow

Input

Type: application/json

Name		Source	Mandatory	Type	Special Format	Description

Name		Source	Mandatory	Type	Special Format	Description
username		Body	YES	String	alphanumeric with _ , - characters only
firstName		Body	YES	String	N/A
lastName		Body	YES	String	N/A
email		Body	YES	String	Email Address Format (JSON Schema Validation)
profile		Body	NO	Object	N/A	The profile object.
groups		Body	NO	Array	N/A	array of group code values
status		body	NO	String - enum	`'active', 'inactive', 'pendingNew'`
password		body	NO	String
confirmation		body	NO	String	Value is as same as password
pin		body	NO
	code		YES	String
	allowed		YES	boolean

Output

Valid Response

Valid Response Sample

{
	"result": true,
	"data": "..."
}

Invalid Response

Error Response Sample

{
    "result":false,
    "errors":{
        "codes":[402],
        "details":[
            {
                "code":402,
                "message":"User account already exists."
            }
        ]
    }
}

Error Codes

Code	Description

Code	Description
400	Database connection error
402	User account already exists.
414	Unable to add user.
611	invalid tenant id provided

Example (CURL)

Request

Calling Add User API

 > CURL -X POST http://127.0.0.1:4000/urac/admin/addUser -d 'username=john&firstName=John&lastName=Doe&email=johndoe@domain.com'

Response

Add User API response

{
	"result": true,
	"data": {
		"id":"57c6eb28962f94a7caab8a22", 
		"token": "719b0aed-edd8-47d5-ada0-9e5f93cb8247"
	}
}