# ServiceNow

> :::important
You can integrate Test Manager with ServiceNow only through UiPath Test Manager Connect. Visit [UiPath Test Manager Connect](https://docs.uipath.com/test-suite/standalone/2023.4/user-guide/uipath-test-manager-connect) to check the resources you can use to create an integration with ServiceNow and other ALM tools, via Planview<sup>®</sup>.
:::

:::important
You can integrate Test Manager with ServiceNow only through UiPath Test Manager Connect. Visit [UiPath Test Manager Connect](https://docs.uipath.com/test-suite/standalone/2023.4/user-guide/uipath-test-manager-connect) to check the resources you can use to create an integration with ServiceNow and other ALM tools, via Planview<sup>®</sup>.
:::

Integrate ServiceNow™ with UiPath Test Manager to manage and automate tests throughout the development lifecycle. With this integration, you can include automated testing directly into your agile planning or directly assign automation to test cases created in ServiceNow™ Test Management 2.0.

## Prerequisites

* UiPath Test Manager administrator account.
* UiPath Test Manager Connector.
* ServiceNow™ account including either Agile Development or Test Management v2 plugin. Alternatively, you can use both plugins for this integration.

## Create an Integration User Account in ServiceNow™

Create a new user account and assign specific roles to it, to make API requests to Test Manager.

1. Log in to your ServiceNow™ instance.
2. Navigate to **Organization** &gt; **Users** &gt; **New** to create a new user for the UiPath® Test Management application.
3. Configure new user account settings with the following conditions:
   * Choose a **User ID**,**First name**,**Last name** and **Password**.
   * Keep the User ID and password at hand for later use.
   * Select **Web services access only** and **Internal Integration User**, as these are required for the integration to work.
4. Go to the **Roles** tab and select **Edit**.
5. Assign the following roles to the newly created user:
   * **import_set_loader**
   * **import_transformer**
   * **scrum_admin**
   * **x_uipa_tm_integrat.admin**

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-126405-0e89c271-d8aec191.webp)
6. Click **Save** to return to the user form.
   :::important
   If you have REST API role access restrictions in your ServiceNow™ configuration, you need to assign additional roles. For example, `nc_platform_rest_api_access` and `rest_service`.
   :::

## Configure a ServiceNow™ Connection

1. Log in to Test Manager as an administrator.
2. Open your project.
3. Navigate to **Project Settings** &gt; **Integration**.
4. Click **New Connection** and select **ServiceNow** from the dropdown.
5. Configure the following connection settings:
   * **Name**: Enter a name for your ServiceNow™ connection.
   * **Description** (Optional): Add a description for reference.
   * **Server URL**: Add the ServiceNow™ server URL. For example: `https://environment.service-now.com/`.
   * **User**: Enter the User ID you have configured for your integration user account.
   * **Password**: Enter the associated password.
   * **Defect Type**: Select a defect type from the dropdown. For now, you can only choose **Defect**.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125746-f1e88725-d0946d67.webp)
6. Click the connection to expand the panel and copy the **API Key** for later use.
7. Open the **Application Navigator** in ServiceNow™ and use the search function to find **UiPath® Test  Integration**. If prompted to switch the application scope, select the one you are currently working with.
8. Configure the following integration settings:
   * **Integration URL**: Add the UiPath® Test Manager URL.
   * **API Key**: Paste the API key.
   * **Logging level**: Select **info** to from the dropdown. The default value is **debug**.
   * **ServiceNow integration user for UiPath® Test Manager**: Enter the User ID you have configured for your integration user account.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-docs-image-125794-7fd49a93-d30da562.webp)
9. Click **Save**.

## Managing ServiceNow™ Connections

The following table lists the actions that you can take to manage your ServiceNow<sup>TM</sup> connections.

 <colgroup>
  <col/>
  <col/>
  <col/>
 </colgroup>
 
  
     Action  
     Description  
     Procedure  
  
 
 
  
    Edit 
     Edit your connection settings.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Click the Settings button to open Project Settings. 
         In the Integration list, click a ServiceNow connection to expand the panel. 
         Click Edit to configure the connection. 
         Click Save to confirm. 
      

  
  
    Delete 
     Delete the selected connection and its associated requirements.  
   
      
         Log in to the Test Manager as an administrator. 
         Open your project. 
         Click the Settings button to open Project Settings. 
         In the Integration list, click a ServiceNow connection to expand the panel. 
         Click Delete to remove the connection. 
         Click Ok to confirm. 
      

  
 

## Related articles

[Defect synchronization](https://docs.uipath.com/test-manager/standalone/2024.10/user-guide/defect-synchronization#defect-synchronization)