Skip to main content

Overview

Organization Admins can invite designer users to their organization via email. Invited users receive a secure invitation link, can be pre-assigned roles and groups, and go through a guided activation flow before becoming active members.
Only users with the Organization Admin role can invite new designer users.
SMTP is required. Invitations and password-recovery emails are dispatched by Keycloak. On self-hosted deployments the client must configure SMTP in Keycloak (per realm) before either flow will work — without it, invitations fail silently. See Email (SMTP) configuration.

Accessing user invitations

The invitation feature is available from the Designer Users page:
1

Navigate to Designer Users

Go to Organization Settings → Access Management → Designer Users
2

Open the invite dialog

Click + and select Invite user
Designer Users page with the + menu open, showing Invite user and Create user

Invitation form

When inviting a designer user, you can configure the following options. Email and Organization-Level Roles are required. A Workspace Member also needs a role in at least one workspace. End-users are invited from Organization Settings → Access Management → End-Users. The end-user invite form has Email, Set User First and Last Name, Groups Membership, and Runtime Attributes.
Invite user form with email, name, organization-level and workspace-level roles, and runtime attributes
Pre-assigning roles and groups during invitation saves time and ensures users have the correct access from their first login.

Creating a user directly

Instead of sending an invitation, an Organization Admin can create the account and set its password in one step. No invitation email is sent: share the credentials with the user through your own channel. Create users directly when your organization signs users in with a username instead of an email invitation. Invitations are turned off for those organizations.
1

Open the create dialog

On the Designer Users or End-Users page, click + and select Create user. The Create Designer User or Create End-User dialog opens.
2

Enter the account details

Fill in Email, First name, Last name, Password, and Confirm password. The password needs at least 8 characters, including one uppercase letter, one lowercase letter, one number, and one special character, and it can’t be the same as the email address.
3

Assign access

For a designer user, set the Organization-Level Roles and, for a Workspace Member, the Workspace-Level Roles. Add Runtime Attributes if needed.
4

Create the user

Click Create User. A “User created successfully” notification confirms the account.
Create Designer User dialog with account details and password fields

Invitation workflow

Sending an invitation

1

Enter email address

Provide the email address of the user you want to invite
2

Configure access (optional)

Select organization and workspace roles (designer users) or groups (end-users), and any runtime attributes
3

Send invitation

Click Invite User to create the user and trigger the invitation email
When you send an invitation:
  1. A user account is created in Keycloak with:
    • The provided email address
    • Selected runtime roles and groups
    • email verified set to false
    • Required actions: update password and update profile
  2. A user record is created in FlowX with:
    • Assigned selections (roles, groups, attributes)
    • Status: Pending
    • Organization Owner role (if selected)
  3. An invitation email is sent to the user
A success notification confirms: “Invitation sent successfully”

Invitation email

The invited user receives an email with the following content:

Invitation email

Subject: You’ve been invited to your FlowX.ai accountHi,You’ve been invited to join the FlowX Platform to test our new Agentic Apps.This early access will let you explore how Agentic Apps work and give feedback on the experience before the broader rollout.[Accept Invitation]Best
Invitation links are valid for 2 days. After expiration, the user will need a new invitation.

Inviting users from a CSV file

To invite many users at once, upload a CSV file.
1

Open the bulk invite dialog

On the Designer Users or End-Users page, open the ⋮ menu and select Invite from CSV. The Bulk Invite Designer Users or Bulk Invite End-Users dialog opens.
2

Prepare the file

Click Download CSV Template to get the expected columns, then fill in one user per row.
3

Upload and import

Drop the file on the dialog or click Upload File, then click Import File. The dialog accepts CSV files up to 25 MB, with up to 500 users per file.
4

Review the results

The Import Complete screen shows how many users were invited and how many were skipped. Download the skipped rows as import-skipped.csv to see which rows were not imported.
The template columns depend on the page: Rows whose email already belongs to a user are skipped. Imported users start in Pending status and receive the same invitation email as a single invite.
CSV invitations are not available for organizations that sign users in with a username. Create those users directly instead.
Bulk Invite Designer Users dialog with Download CSV Template and the file upload area

User activation flow

When the invited user clicks the invitation link, they complete a two-step activation process:

Step 1: Set password

The user creates a secure password for their account:
  • Minimum 8 characters, maximum 64 characters
  • Must include at least one uppercase letter, one lowercase letter, one number, and one special character (!@#$%^&*()_+-)
  • Cannot be the same as the user’s email address
  • Upon submission, proceeds to profile setup

Step 2: Complete profile

The user provides their profile information: Upon submission:
  • User profile is updated with the provided information
  • email is marked as verified
  • User is redirected to the login page with a success message

First login

After completing activation and logging in for the first time:
  • User status changes from Pending to Active
  • First name and last name are populated in the FlowX user profile
  • User appears in the Designer Users list with Active status

Handling expired invitations

If a user clicks an invitation link after it has expired (more than 2 days), they see an “Invite link expired” page.
To resolve an expired invitation, the Organization Admin needs to send a new invitation to the user.

User statuses

Disabling and enabling users

Administrators can change a user’s status from the Designer Users or End-Users page:
1

Open user actions

Find the user in the users list and open the context menu (three-dot menu)
2

Select the action

Choose Disable User to deactivate an active user, or Activate User to reactivate a disabled user
3

Confirm the action

Confirm the action in the dialog. The user’s status updates immediately.
Disabled users cannot log in until their account is re-activated.

Resending invitations

If a user’s invitation has expired or was lost, you can resend it:
1

Find the pending user

Find the user with Pending status in the Designer Users or End-Users list.
2

Select Resend Invitation

Open the context menu and select Resend Invitation.
3

Invitation sent

A new invitation email is sent with a fresh activation link.
Resend Invitation is available for both designer users and end-users with Pending status.

Editing your own profile

Any signed-in user can update their own details from the account menu.
1

Open your profile

Click your avatar in the top bar and select Profile settings. The User Details dialog opens.
2

Edit your details

Update your first and last name. Your email address and roles are read-only here: an Organization Admin changes them from the users list.
3

Change your password (optional)

Use the Change password step to set a new password. This step is hidden when you sign in through an external identity provider.

Best practices

Configure the correct organization and workspace roles during invitation to ensure users have proper access from day one.
Add end-users to groups during invitation to organize them into teams and apply group-based permissions.
Regularly check the Designer Users page for users with Pending status to identify invitations that may need to be resent.
Let invited users know to expect the invitation email and complete activation within 2 days to avoid expiration.

Limitations

The following features are planned for future releases:
  • Cancel invite - Ability to cancel a pending invitation
  • Copy invite link - Ability to copy the invitation link directly

FlowX SaaS Overview

Learn about FlowX SaaS deployment and multi-tenancy

Access Management

Configure IAM and Keycloak settings

Workspaces

Understand workspace organization

Roles & Permissions

View the complete roles and permissions reference
Last modified on November 6, 2026