Skip to main content
Required permissions: You need Read on Manage Users to view the users list, Create to add users, Update to edit users and assign or revoke roles, and Delete to delete users. See roles and permissions.

Creating Users

Administrators can add new users from the Users section of the Admin Portal. You need Create on Manage Users. Without it, the New User button doesn’t appear.

Step 1: Open the Create User Dialog

  1. Navigate to Administration → Users
  2. Click the New User button in the top-right corner Create user button

Step 2: Enter User Information

Create user form

Required Fields

string
required
Enter the user’s full name as it should appear in the system.
string
required
The primary email address for user authentication.

Optional Fields

string
An alternative email for non-authentication communications.Options:
  • Leave blank to use the account email for all communications
  • Check “Use same as account email” to automatically copy the account email
  • Enter a different email for separate communication preferences
string[]
One or more roles to assign to the user. Roles control what the user can see and do in the Admin Portal.If you leave this field empty, the user gets the default Viewer role. See Roles and permissions.
Behavior
  • Users are created with an Active status by default.
  • There is no invitation workflow — notify new users manually after creation.
  • The Account Email must be unique and cannot be changed after activation.
  • If Contact Email is left blank, it defaults to the account email.
Limitations
  • No bulk import
  • No password setup (handled via SSO or first-login reset)
  • No custom templates or attributes
Common Errors
  • Duplicate or invalid email address
  • Missing required fields

Viewing and Searching Users

The Users list displays all active users in your instance, including a Roles column that shows each user’s assigned roles. Inactive and deleted users are hidden by default.

Status Indicators

User status is displayed with color-coded badges for quick identification:
Active - User can access the systemPending - User invited but not activatedInactive - Account temporarily disabledDeleted - User has been removed
Currently, the interface displays only active users. Deleted and inactive users are filtered from the view.
Use the Search users… box above the list to find users by name or email. Results update as you type. The search term is saved in the page URL as a search query parameter. Reloading the page or sharing the link keeps the list filtered. For example, searching for jane adds this to the URL:
Filtering by user status and bulk operations are not yet supported.

Individual Actions

Click a user row to open the edit view, or use the ⋮ actions menu for quick operations such as Edit or Delete.

Editing Users

Administrators can update user information directly from the list. You need Update on Manage Users to edit a user or to assign and revoke roles. Saving a user’s edited permissions as a new role also needs Create on Manage Roles. All edits are logged automatically in the audit trail updatedAt, updatedBy).

Accessing the Edit User Feature

There are two ways to edit a user:

Method 1: Click on User Row

Click anywhere on a user’s row in the user list table to open the edit modal. User list with row actions

Method 2: Actions Menu

  1. Click the actions menu (⋮) in the user’s row
  2. Select Edit from the dropdown User row actions menu
Editable Fields
  • Name — updates display name throughout the system
  • Account Email — must remain unique; affects login credentials
  • Contact Email — optional; defaults to account email
Non-Editable Fields User ID, Firm ID, Instance ID, Status, and Azure Entra ID. Roles and permissions Manage a user’s roles on the Permissions tab of the user page. From there you can assign or revoke roles, review the user’s effective permissions, and save edited permissions as a new role. See Roles and permissions. Behavior Edits take effect immediately upon Save and are recorded in the audit trail. The system does not automatically notify users — admins should communicate any critical changes manually. Limitations
  • Status changes managed separately
  • No bulk edit or version history

Deactivating and Deleting Users

Deleting a user removes their access to Entegrata while preserving their historical data for audit purposes. You need Delete on Manage Users. Without it, Delete doesn’t appear in the actions menu.
Deleted users cannot log in or access the system, but their historical data and audit trails remain intact.

Step 1: Access Delete Option

Click the actions menu (⋮) in the user’s row and select Delete. User row actions menu

Step 2: Confirm Deletion

A confirmation dialog will appear to prevent accidental deletions. Delete user confirmation dialog Behavior
  • Status changes to Deleted, ending all sessions and invalidating tokens
  • Audit logs and historical data remain intact
  • Deletions are recorded with who performed the action and when
Recovery Deleted users cannot be restored through the UI. Contact Entegrata Support if recovery is required. Best Practices
  • Confirm deletion is appropriate and reassign any owned resources
  • Notify relevant team members and document the reason
Retention Data for deleted users remains under your firm’s retention policy until manually purged.

User Overview

Understanding user management basics in the platform

Roles and permissions

Control what users can see and do with roles

Troubleshooting

Common issues and solutions for user management