# Create a Service User

Source: https://userguide.qualytics.io/settings/access/service-users/managing/create-service-user/

Use the Create Service User action to add a new Service User for automated systems to securely interact with Qualytics.

> **Info: Permissions**
>
> Only users with the **Admin** role can create Service Users. See the [Permissions](https://userguide.qualytics.io/settings/access/service-users/deep-dive/permissions/) page for details.

## Fields

The service user form contains the following fields:

![form-annotated](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/form-annotated.png)

| REF. | FIELD | DESCRIPTION |
| --- | --- | --- |
| 1 | Name | A descriptive name for the Service User (e.g., `svc-dbt-cloud`, `svc-airflow`). This becomes the account identifier. |
| 2 | Role | The role assigned to the Service User: Admin, Manager, or Member. Start with the least privileged role needed. |
| 3 | Teams | Teams the Service User should belong to. The **Public** team is included by default. |

## Steps

**Step 1:** In the **Access** tab, click the **Add**  button in the top right corner.

![step-1-add-button](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-1-add-button.png)

**Step 2:** A menu opens with the available options.

![step-2-menu-appears](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-2-menu-appears.png)

**Step 3:** Select **Service User**  from the menu.

![step-3-service-user-option](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-3-service-user-option.png)

**Step 4:** Fill in the Service User fields and review your selections.

![step-4-form-filled](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-4-form-filled.png)

**Step 5:** Click the **Finish** button to create the Service User without generating a token, or click **Next** to also generate a Service Token (see [Optional: Generate a Token](https://userguide.qualytics.io/settings/access/service-users/managing/create-service-user/#optional-generate-a-token) below).

![step-5-click-finish](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-5-click-finish.png)

**Step 6:** A success notification confirms the Service User has been created. The new account appears in the users list with a **Service** badge.

![step-6-success](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-6-success.png)

## Optional: Generate a Token

You can generate a Service Token during account creation by clicking **Next** instead of **Finish** in Step 5.

**Step 5 (alternative):** Click **Next** to proceed to the token generation step.

![step-5-alt-click-next](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-5-alt-click-next.png)

**Step 6 (alternative):** Fill in the token name and expiration.

![step-6-alt-token-form](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-6-alt-token-form.png)

> **Info**
>
> For more details on Service Token fields and management, see the [Service Token documentation](https://userguide.qualytics.io/settings/access-tokens/service-token/introduction/).

**Step 7 (alternative):** Click **Finish** to create the Service User and generate the token.

![step-7-alt-click-finish](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-7-alt-click-finish.png)

**Step 8 (alternative):** A modal appears displaying the newly generated token.

![step-8-alt-token-success](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-8-alt-token-success.png)

**Step 9 (alternative):** Save the token using one of the two options:

**Tab: Copy**

Click the **Copy**  button to copy the token to your clipboard.

![step-9-alt-token-copy](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-9-alt-token-copy.png)

**Tab: Download**

Click the **Download**  button to save the token as a `.txt` file.

![step-9-alt-token-download](https://userguide.qualytics.io/assets/settings/access/service-users/managing/create-service-user/step-9-alt-token-download.png)

> **Warning**
>
> The token is shown **only once**. Make sure to copy or download it before closing the modal — it cannot be retrieved later.

*Last updated: August 6, 2026.*
