> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowx.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Inviting Users

> Learn how Organization Admins can invite designer users to their organization via email with role assignments and secure activation.

## 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.

> [!NOTE]
>
> Only users with the **Organization Admin** role can invite new designer users.

> [!NOTE]
>
> **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](https://docs.flowx.ai/6.x/setup-guides/access-management/configuring-an-iam-solution.md#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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/invite-user-menu.png)

## 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.

| Field | Description |
| - | - |
| **Email** | Email address the invitation is sent to |
| **Set User First and Last Name** | Optionally pre-fill the user's first and last name |
| **Organization-Level Roles** | **Workspace Member**, **Organization Admin**, or **Organization Owner** |
| **Workspace-Level Roles** | Click **Add Workspace** to give the user a role in one or more workspaces |
| **Runtime Attributes** | Set custom user attributes |

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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/invite-user-modal.png)

> [!TIP]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/create-user-modal.png)

## 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

> [!TIP]
>
> A success notification confirms: "Invitation sent successfully"

### Invitation email

The invited user receives an email with the following content:

> [card] Invitation email
>
> **Subject:** You've been invited to your FlowX.ai account
>
> Hi,
>
> 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

> [!WARNING]
>
> 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:

| Page | Columns |
| - | - |
| **Designer Users** | `email`, `firstName`, `lastName`, `organizationRole`, `allowNameEdit`, then one column per runtime attribute |
| **End-Users** | `email`, `firstName`, `lastName`, `groups`, `allowNameEdit`, then one column per runtime attribute. Separate several groups with `\|`. |

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.

> [!NOTE]
>
> 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](https://s3.eu-west-1.amazonaws.com/docx.flowx.ai/6.x/bulk-invite-csv-modal.png)

## 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:

| Field | Required | Description |
| - | - | - |
| **First name** | Yes | User's first name |
| **Last name** | Yes | User's last name |

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.

> [!WARNING]
>
> To resolve an expired invitation, the Organization Admin needs to send a new invitation to the user.

## User statuses

| Status | Description |
| - | - |
| **Pending** | User has been invited but hasn't completed activation |
| **Active** | User has completed activation and logged in at least once |
| **Disabled** | User account has been deactivated by an administrator |

### 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.

> [!NOTE]
>
> 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.

> [!TIP]
>
> **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

> [accordion] Pre-assign appropriate roles
>
> Configure the correct organization and workspace roles during invitation to ensure users have proper access from day one.

> [accordion] Use groups for end-user teams
>
> Add end-users to groups during invitation to organize them into teams and apply group-based permissions.

> [accordion] Monitor pending invitations
>
> Regularly check the Designer Users page for users with Pending status to identify invitations that may need to be resent.

> [accordion] Communicate invitation timing
>
> Let invited users know to expect the invitation email and complete activation within 2 days to avoid expiration.

## Limitations

> [!NOTE]
>
> 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

## Related documentation

> [card] [FlowX SaaS Overview](https://docs.flowx.ai/6.x/docs/saas/saas-overview.md)
>
> Learn about FlowX SaaS deployment and multi-tenancy

> [card] [Access Management](https://docs.flowx.ai/6.x/setup-guides/access-management/access-management-overview.md)
>
> Configure IAM and Keycloak settings

> [card] [Workspaces](https://docs.flowx.ai/6.x/docs/projects/workspaces.md)
>
> Understand workspace organization

> [card] [Roles & Permissions](https://docs.flowx.ai/6.x/setup-guides/access-management/roles-permissions-matrix.md)
>
> View the complete roles and permissions reference


## Related topics

- [End-user access management](https://docs.flowx.ai/6.x/setup-guides/access-management/end-user-access-management.md)
- [FlowX.AI 5.6.0 Release Notes](https://docs.flowx.ai/release-notes/v5.x/v5.6.0-march-2026/v5.6.0-march-2026.md)
- [Workspaces](https://docs.flowx.ai/6.x/docs/projects/workspaces.md)
- [Configuring an IAM solution (Keycloak)](https://docs.flowx.ai/6.x/setup-guides/access-management/configuring-an-iam-solution.md)
- [Creating a user interface](https://docs.flowx.ai/6.x/docs/flowx-designer/managing-a-project-flow/creating-a-user-interface.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.