User Management
Create users, assign tenants and roles, enable/disable accounts, and view last login. Users sync from FusionPBX or can be created manually.
User Management
User management in CrystalQore lets you create, edit, and control user accounts across your tenants. Users can be created manually or synchronized from FusionPBX. Each user belongs to one tenant and has a role that determines their permissions.
Overview
User management in the Superadmin panel allows you to:
- Create new user accounts
- Edit user details (email, password, tenant, role)
- Enable or disable accounts
- View last login and tenant association
- Search and filter users across tenants
- Manage users synced from FusionPBX
Creating Users
Navigate to Admin → Users — Open the user management page.
Click Create User — Start the user creation form.
Enter email — The user's email address (used for login).
Set password — Initial password for the user. They can change it after first login.
Assign to tenant — Select the tenant this user belongs to.
Assign role — Choose User, Admin, or Superadmin. See Roles and Permissions for details.
Save — Create the user account.
Required Fields
| Field | Description |
|---|---|
| Unique email address; used as login identifier | |
| Password | Initial password (user can change later) |
| Tenant | The organization the user belongs to |
| Role | User, Admin, or Superadmin |
User email addresses must be unique within the platform. Duplicate emails across tenants are not permitted.
Editing User Details
From the user list or detail view, you can:
- Change email — Update the login identifier (ensure it remains unique)
- Reset password — Set a new password (user will need to use it on next login)
- Change tenant — Move the user to a different tenant (may affect data access)
- Change role — Upgrade or downgrade permissions
- Enable/Disable — Temporarily block or restore login access
Enabling and Disabling Accounts
Disabled users cannot log in. Their data (messages, contacts, etc.) remains in the system. Use disable when:
- An employee leaves but you need to retain records
- Temporarily suspending access for policy violations
- Migrating users between tenants
Enable restores login access immediately.
Viewing User Information
The user list and detail views show:
| Field | Description |
|---|---|
| Login identifier | |
| Tenant | Organization the user belongs to |
| Role | User, Admin, or Superadmin |
| Last login | Timestamp of most recent successful login |
| Status | Enabled or Disabled |
Search and Filter
Use the search and filter controls to:
- Search by email — Find users by partial or full email match
- Filter by tenant — Show only users in a specific tenant
- Filter by role — Show only Users, Admins, or Superadmins
- Filter by status — Show enabled or disabled accounts
FusionPBX Sync
Users can be synchronized from FusionPBX instead of created manually. When you run a sync:
- New FusionPBX users → New CrystalQore user accounts (matched by email or extension)
- Existing users → User details (name, extension, etc.) are updated
- Domain and tenant → Mapped based on FusionPBX domain configuration
See FusionPBX Sync for details on configuring and running synchronization.
Manual vs. Synced Users
- Manual users — Created in CrystalQore directly; may or may not have a matching FusionPBX extension
- Synced users — Created or updated from FusionPBX; typically have extension and call capabilities
Both types use the same login flow and can be managed identically in the Superadmin panel.
Best Practices
- Use strong initial passwords — Or use password reset to let users set their own
- Assign the correct tenant — Wrong tenant assignment blocks access to expected data
- Choose the right role — Start with User; promote to Admin only when needed
- Disable instead of delete — Preserves audit trail and historical data
- Regular sync — If using FusionPBX, run sync periodically to keep user roster current
Related Documentation
| Page | Description |
|---|---|
| Tenant Management | Manage organizations |
| Roles and Permissions | Understand role capabilities |
| FusionPBX Sync | Sync users from FusionPBX |