Service Users
Service Users provide a secure and centralized way to authenticate automated systems and integrations with the Qualytics API. Unlike Personal Accounts that are tied to individual users, Service Users are dedicated accounts designed specifically for automation, pipelines, and integrations.
What Are Service Users?
Service Users are dedicated user accounts created specifically for automation and integrations. They have the following characteristics:
Key Characteristics
- No interactive login: Service Users cannot log into the Qualytics web interface
- Administrator-managed: Only administrators can create and manage service users
- Independent lifecycle: Service Users are not tied to individual users
- Role-based permissions: Can be assigned Admin, Manager, or Member roles
- Team membership: Can be assigned to specific teams for scoped access
Info
Every automated or system-driven integration should use a Service User instead of a Personal Access Token.
Service Users vs Personal Accounts
Understanding the difference helps you manage access appropriately across the platform.
| Feature | Service User | Personal Account |
|---|---|---|
| Represents | A dedicated account for automation | A human user |
| Login | Cannot log in — API-only access | Can log into the web interface |
| Created by | Administrators only | SSO/login or Directory Sync |
| Token type | Service Tokens (admin-managed) | Personal Access Tokens (self-service) |
| Best for | Pipelines, integrations, shared automation | Interactive use, development, testing |
| Lifecycle | Independent of any individual user | Tied to the individual person |
Warning
Never use Personal Access Tokens in production pipelines — they will break when the user is offboarded, disabled, or role-changed.
Deep Dive
Understand how Service Users work — use cases, quick reference, and security model.
-
How It Works
When to use Service Users, quick reference table, and comparison with Personal Access Tokens.
-
Permissions
Roles required to create, manage, and configure Service Users and their tokens.
-
Best Practices
Security guidelines, naming conventions, least privilege, and token expiration strategy.
Managing
Create, edit, deactivate, and reactivate your Service Users.
-
Create Service User
Step-by-step guide to create a new Service User with token generation.
-
Edit Service User
Update a Service User's role or team assignments.
-
Deactivate Service User
Soft-delete a Service User while retaining its data for future reactivation.
-
Reactivate Service User
Restore a previously deactivated Service User.
-
Generate Token
Generate a new Service Token for a Service User.
-
Sort Service Users
Organize the Service Users list by name, role, or activity.
-
Filter Service Users
Narrow down the list by role, team, or status.
-
List Columns
Understand the Users list columns: name, type, role, last active, teams, and created.