Create user account

The Create user account action node creates a new user in the solution or can optionally update an existing user. Roles can be assigned to determine the user's permissions. A welcome email can be automatically triggered, enabling the user to login immediately.

Usage

This action node is used when you would like client users to be able to give other people access to the apps in a solution. For example, a client user with a custom Administrator role may be granted the permission to add users with a Coordinator role.

Users in a solution must have unique email addresses. The default behavior of Create user account is to throw an error (UserAccountAlreadyExistException: Appfarm error code 14007) when run with an email that is already assigned to user in the solution. To allow existing users, and optionally update their User object, select the Accept Existing User checkbox.

When the action node successfully completes, the User object is immediately created in the database. It is not necessary to persist any changes.

Important

  • The user running this action node must have a role with the appropriate permissions to create a new user and assign any selected role. Read more under Users.

  • The appropriate user account manipulation properties must be enabled for the relevant environment.

Properties

PropertyDescription

Email

The user's email address. Must be unique in the solution. If the email is already registered in the solution and Accept Existing User is not selected, the action node will fail.

First Name

The user's first name.

Last Name

The user's last name.

Phone

The user's phone number.

Role Memberships

The roles that the user should be a member of.

Accept Existing User

Run the action node even if a user with the specified Email already exists in the solution. If this property is not selected and the user does already exist, the action node will fail. See Usage for more information. If Add to Data Source is configured, the User object will be added there. The welcome email will not be sent, even if Send Welcome Mail is selected.

Update User Properties

Available if Accept Existing User is selected. Update an existing user with the First Name, Last Name, and Phone values.

Add Roles

Available if Accept Existing User is selected. Add the roles selected under Role Memberships to an existing user.

Add to Data Source

Add the User object to the selected data source. If the data source is many-cardinality, the object will be added. If the data source is single-cardinality, the object will replace any existing object.

Send Welcome Mail

Send an email with a login link. This email template can be customized in a Login configuration, or overridden for this action node only by selecting Override Welcome Mail.

Override Welcome Mail

Available if Send Welcome Email is selected.

Override the subject and body of the welcome email.

Password Link TTL

Available if Override Welcome Email is selected.

Specify how long the reset password or login link in the welcome email will be valid, in seconds, up to a maximum of 1 week. The default is 86,400 seconds (24 hours).

Login Link Redirect Path

Available if Override Welcome Email is selected. Redirect the user to the specified path after they click the login link. The path must start at the domain root, for example: /READABLE_ID/VIEW_NAME/SUBVIEW_NAME?URL_PARAM=value.

Subject

Available if Override Welcome Email is selected. Override the subject of the welcome email.

Body Text Template

Available if Override Welcome Email is selected. Override the plain text email body. See Login configuration for available parameters.

Body HTML Template

Available if Override Welcome Email is selected. Override the HTML email body. See Login configuration for available parameters. A Body Text Template is also required when you specify an HTML template.

Last updated