Create User Smart Service

Overview

The Create 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, unless the Send Account Creation Email input is set to false. 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.

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.

Properties

  • 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 the 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 the new user. Yes No
Nickname Text The nickname of the new user. No No
Middle Name Text The middle name of the new user. No No
Last Name Text The last name of the new user. Yes No
Email Text The email of the new user. Yes No
Send Account Creation Email Boolean If true (default), an account creation email with a temporary password will be sent to the new user.
If you are using external authentication, such as LDAP, we recommend setting this input to false.
Yes No

See also: Creating a New User

Node Outputs

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

a!createUser()

The Create 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.

Syntax

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

Inputs

  • 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.
  • sendAccountCreationEmail (Boolean): If true (default), an email with a temporary password will be sent to 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

On This Page

FEEDBACK