Creating a user with the REST API

Enables you to create a new MACRO user.

You must include an authorization token in this request which is generated from the /token call.

URL

http://localhost/MACRORESTAPI/api/users/createuser

POST

You must include these parameters in the body of the call:

Parameter	Type	Description
userid	string	User name for new user
password	string	Temporary password for new user (must comply with password policy)
fullname	string	Full name for new user
adminuser	string	The system administrator who is to be responsible for dealing with forgotten passwords for the new user (may be left blank)
email	string	Email address for new user (may be left blank)
isadmin	boolean	True to assign system administrator status, False to create as standard user

This example uses the RestSharp library.

Creating a new user Bob Jones:

var client = new RestClient(_baseurl + "api/users/createuser");

var request = new RestRequest(Method.POST);

request.AddHeader("Authorization", "Bearer " + _accesstoken);

request.AddParameter("userid, "bobj");

request.AddParameter("password", "he3h9wwm2");

request.AddParameter("fullname", "Bob Jones");

request.AddParameter("adminuser", "daveop");

request.AddParameter("email", "bob.jones@gmail.com");

request.AddParameter("isadmin", "false");

The result code is returned:

Success

Value	Description
Success	The operation was successful
PermissionDenied	The current user does not have the relevant MACRO permissions to perform the action
InvalidUserName	The given user name is not valid, e.g. it contains invalid characters, too many characters or is empty
InvalidFullName	The given user full name is not valid, e.g. it contains invalid characters, too many characters or is empty
InvalidPassword	The specified password is not valid, e.g. it is empty or does not comply with the current Password Policy
InvalidEmail	The specified email address is not valid, e.g. it contains invalid characters, too many characters or does not contain the "@" character or a dot after the @
UserExists	User already exists, when attempting to create a user
UserNotFound	User does not exist, when attempting to specify the system administrator for a user
Unknown	An unknown error occurred