Add User Smart Service

The Add User Node allows you to create new users on the system while executing your process application. A temporary password will be automatically generated and sent to the email address provided. The temporary password never expires and can only be used once. The user is forced to change the password when they log in for the first time.

Note that the password parameter has been deprecated in favor of using auto-generated passwords. Existing processes which use the password parameter will continue to be supported.

Permissions Needed

Only System Administrators can run this smart service.


  • Category: Identity Management

  • Icon:

  • Assignment Options: Attended/Unattended

Configuration Options

This section contains tab configuration details specific to this smart service. For more information about common configurations see the Process Node Properties page.

Data Tab

Node Inputs

Input Data Type Description Required Multiple
Username Text The username of new user.
A username can only contain letters, numbers, and the following special characters: @ . _ - .
It must not match an existing username regardless of case. For example, if john.doe already exists, you cannot enter JOHN.doe
Yes No
First Name Text The first name of new user. Yes No
Nickname Text The nickname of new user. No No
Middle Name Text The middle name of new user. No No
Last Name Text The last name of new user. Yes No
Email Text The email of new user. Yes No

See also: Creating a New User

Node Outputs

The node returns a user object for the new user added to the system.


The Add User smart service is available as an expression function that can be executed inside a saveInto on a component or as part of a Web API.


a!createUser(username, firstName, nickname, middleName, lastName, email, onSuccess, onError)


  • username (Text): The username of the new user.
  • firstName (Text): The first name of the new user.
  • nickname (Text): The nickname of the new user.
  • middleName (Text): The middle name of the new user.
  • lastName (Text): The last name of the new user.
  • email (Text): The email address of the new user.
  • onSuccess (Any Type): A list of saves or an HTTP response to execute after the smart service executes successfully. Created with a!save() or a!httpResponse(). The following function variable is available when configuring this input:
    • fv!user (Any Type): The user that was created.
  • onError (Any Type): A list of saves or an HTTP response to execute when the smart service does not execute successfully. Created with a!save() or a!httpResponse().
Open in Github Built: Fri, Jun 03, 2022 (01:08:29 PM)

On This Page