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

Accept Existing User

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

Send 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

Body HTML Template

Last updated