/admin/users) lists all registered accounts and gives administrators the tools to create, edit, moderate, and delete users.
Viewing and filtering users
The table is paginated at 15 per page and supports the following filters:| Filter | Options |
|---|---|
| Search | Name, email, or customer_uuid |
| Role | Any role name defined in Spatie Permission |
| Banned | yes / no |
| Status | active (updated in last 30 days) / inactive |
| Date range | Registered after / registered before |
| Deleted | Show only soft-deleted, include soft-deleted, or default (active only) |
created_at, name, email, or updated_at in ascending or descending order.
Each user row shows:
- Name and email
- Spatie roles (e.g.,
admin,customer) - Assigned pricing plan (if any)
- Email verified status
- Ban status and ban reason
customer_uuid— a UUID auto-generated for each customer to isolate their ElevenLabs resources- KYC status
Creating a user
Fill in the details
Required fields: Name, Email, Password (with confirmation), Role.
Optional: Pricing plan, Email verified checkbox.
The password must satisfy the application’s default Laravel password rules (min 8 characters, mixed case, numbers, symbols unless the defaults have been relaxed).
Editing a user
Click the edit icon on any user row. You can update the name, email, role, pricing plan, and optionally reset the password. Changing the pricing plan cancels the user’s existingactive or trialing subscription and creates a fresh one on the new plan.
Managing roles
Each user can hold exactly one primary role at a time (admin or customer). Role assignment uses syncRoles, so assigning a new role removes all previous roles. You can also update the role in isolation via the Update role quick-action without opening the full edit form.
Managing permissions
Individual permissions are managed at the role level, not per user. Navigate to Admin → Role Permissions to see all roles and their assigned permissions grouped by category:| Category | Example permissions |
|---|---|
| Admin Pricing | admin.pricing-management.view, .create, .edit, .delete |
| Admin Users | admin.users.manage |
| Admin Settings | admin.settings.manage |
| Admin Cache | admin.cache.manage |
| Agents | agents.create, agents.edit |
| Knowledge Base | knowledge.manage |
| Phone Numbers | phone.manage |
| Batch Calls | batch.manage |
| Blog | manage-blog |
Banning and unbanning users
Banning prevents a user from accessing the application without deleting their data.Open the ban dialog
Click Ban on the user row. A dialog prompts for an optional reason (max 500 characters).
Confirm the ban
The
is_banned, banned_at, ban_reason, and banned_by fields are set on the user. The banning admin’s ID is recorded.Impersonating a user
Impersonation lets you log in as another user to diagnose issues from their perspective.Click Impersonate
Find the user in the table and click Impersonate. You cannot impersonate banned users.
Browse as the user
Your session switches to the target user. A session variable (
impersonate_original_user) stores your original admin user ID.Email verification
- Verify email — Manually sets
email_verified_atto the current timestamp. Use this when a customer cannot receive the verification email. - Unverify email — Clears
email_verified_at, forcing the user to re-verify.
KYC management
KYC is optional and controlled by feature flags in System Config. When enabled, each user has akyc_status field:
| Status | Meaning |
|---|---|
not_submitted | User has not submitted KYC |
pending | Submission received, awaiting review |
approved | KYC approved |
Soft deleting and restoring users
Clicking Delete performs a soft delete (setsdeleted_at) and records the deleting admin’s ID in deleted_by. Soft-deleted users no longer appear by default but their data is preserved.
To view deleted users, set the Deleted filter to Only deleted or Include deleted.
To restore a soft-deleted user, click Restore on their row.
Permanent deletion
Onlysuper-admin accounts can permanently delete a user. Use the Force delete action on a soft-deleted user row. You cannot permanently delete your own account.
Customer UUID
Every customer account is assigned acustomer_uuid (UUID v4) at registration. This UUID is passed to ElevenLabs when creating agents, knowledge bases, and other resources, ensuring each customer’s AI assets are isolated from other customers on the same ElevenLabs workspace. The UUID is visible in the user table and can be searched.