Add User

General Information

Service	API	Method
urac	/admin/addUser	POST

Data Models: Users, Tokens

Workflow: %Link to Architecture Page%

Input

Name	Source	Mandatory	Type	Special Format	Description
tId	Body or Query	YES	String	N/A	the Id of the tenant where this user is added
tCode	Body or Query	YES	String	N/A	the code of the tenant
username	Body	YES	String	N/A	alphanumeric with _ , - characters only
firstName	Body	YES	String	N/A
lastName	Body	YES	String	N/A
email	Body	YES	String	N/A
profile	Body	NO	String	N/A
groups	Body	NO	Array	N/A	array of group code values

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
402	User account already exists.
403	Unable to register user. please try again.
413	Invalid profile field provided. Profile should be a stringified object.
414	Unable to add user.
611	invalid tenant id provided

Example (CURL)

Request

Calling YOUR API

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

Response

YOUR API response

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