# Connect to ServiceNow

## Overview

To integrate Finout with your ServiceNow instance, designate a user account that Finout will use to make API calls on your behalf. This ensures smooth and secure communication between Finout and your ServiceNow instance.

{% hint style="info" %}
**Note**: 

You need administrator-level access to your ServiceNow instance. This access is required to configure the user for the integration and to create an OAuth application within your ServiceNow instance, which is essential for the integration.
{% endhint %}

**ServiceNow Configuration Workflow:**

1. [Choose a User ](#id-1.-choose-a-user-for-the-integration)
2. [OAuth Authentication](#id-1.-oauth-authentication)
3. [Add ServiceNow credentials to Finout](#id-4.-servicenow-configuration)

## 1. **Choose a User for the Integration**

1. In ServiceNow, create or use a dedicated user with the appropriate ACL permission to read incident metadata fields and create incidents.\
   The user should have the following read ACL permissions:
   1. sys\_db\_object
   2. sys\_db\_object.\*
   3. sys\_dictionary
   4. sys\_dictionary.\*
   5. sys\_glide\_object

## 2. OAuth Authentication

To enable your instance to receive inbound calls from our service, create an OAuth application within your instance to initiate a token exchange process. Follow these steps to set it up:

1. Navigate to **System OAuth > Application Registry**.\
   ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcogaVWVv39yjh663txDv_EY2aNOLtyNq00FnnWZ3wc4HZrLRwd2rEfYsJe4HP2VTSiczGCEcUuYYBLmTrdItD9BmGKolsUfX1gbEL2z_wZp0szNDB_sZTYwZEHHgqinetZgGw1?key=TOtpaZF9ZqHYGVt28ekIvfeb)
2. Click **New** and then click **Create an OAuth API endpoint for external clients**.\
   ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeTxhxyaM8k3lceFEJRvnGp7oejDx9w2MJY1VAGJ1FBmxPGUzeC8yj5jnnGG7zh9Pw875NShRnJlSzGqyp73lZ4g4CGtiSOFm13lxpeWSupoqBn5nrHCqw9A_5fg6vBuIinOvmPpA?key=TOtpaZF9ZqHYGVt28ekIvfeb)\
   ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXclRx1hIiFGZYfa1_-2jkNmB8C5w2aeTeXw-cJZXKifyx0QmfVqoEGOiMFASZjIQOqTRDzKl0RinhLNUSe0TCZrB5s4VDiM-F_o7m7P18q1bsVUfRxuZ0vP9AGYGXP3ZjJfXeEUrA?key=TOtpaZF9ZqHYGVt28ekIvfeb)
3. Fill in the following fields:
   1. Name: \<ANY>
   2. Client Type: Integration as a service

      <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong>: Make sure to leave the <strong>Redirect URL</strong> and <strong>Logo URL</strong> empty.</p></div>

      \ <br>

      <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXcnhMaORZ08pqf5Z9DscYt_Jw9hPG4qZelO-uhTTuoSA7ZN-8cscyrMstmayFx0QpXRMs67aJl0Vli7G8L7vXmzSDHx2ePiuY-NObRDgJfmNBklemZVCfPbzzn0qH5OSiy9eVi9gw?key=TOtpaZF9ZqHYGVt28ekIvfeb" alt=""><figcaption></figcaption></figure>
4. Press **Submit**.\
   You will be redirected to the list of all available apps.
5. Navigate to the app that you created and press the **lock icon** next to the Client Secret field. This will reveal the Client secret, which you will need to provide to Finout later.<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeiaWWD4qYVTxlETCcXggMfBXXzgrd_v5O_3H98KFFKy7i5JIw-Ds_L9zCYOIYjJNWQNaR8lINegqJD6fbjILf7309O397FCK8Nv6B1n3-nkNjgmKnYeNPV1UNhlhOOGA2SGvvNRw?key=TOtpaZF9ZqHYGVt28ekIvfeb" alt=""><figcaption></figcaption></figure>
6. In Finout, fill in the following information:
   1. ServiceNow Instance URL
   2. ServiceNow Client ID
   3. ServiceNow Client Secret
   4. ServiceNow User Name
   5. ServiceNow User Password

{% hint style="info" %}
**Note**: The username and password should belong to the dedicated user created for the integration.
{% endhint %}

## 3. ServiceNow Configuration in Finout

1. In Finout, navigate to **Settings > Integrations**.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong>: You can connect with only one instance.</p></div>

   <br>

   <figure><img src="https://3858159242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWqjB2puKXPDR7L86FX2e%2Fuploads%2FBz2mq7HxMNNw4C3bG3Og%2Fimage.png?alt=media&#x26;token=8fa299b1-6a78-4e9c-995f-27692a3f5932" alt=""><figcaption></figcaption></figure>
2. Click **Add Integration**.

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfvNaOcxpvEhnysreuvjrXpA9Nyv4vuEiv1HWOQGYswthnGX5XJzjlH6lvdNb_3pADKL3_ENi4dFnz7VsMV7wiqGm4qqt0wUzIqRtiCX24j_w_jEGaIISm3lNeiP0vL0qQSFNeITw?key=LD16-V03YuCW3PuKLiiikgCM" alt=""><figcaption></figcaption></figure>
3. Under ServiceNow, click **Connect Now**.\
   The **ServiceNow Integration** wizard appears.<br>

   <div align="left"><figure><img src="https://3858159242-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWqjB2puKXPDR7L86FX2e%2Fuploads%2Fi8UomXWRYNNWQNjmSndA%2Fimage.png?alt=media&#x26;token=9b877620-000d-4cc3-86b8-328a2e0c9977" alt=""><figcaption></figcaption></figure></div>

   1. Enter your **ServiceNow Instance URL**.
   2. Enter the **Client ID** from the ServiceNow OAuth application.
   3. Enter the **Client secret** associated with the ServiceNow OAuth application.
   4. Enter the **ServiceNow User name** for Authentication.

      <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong>: The user should have the following read ACL permissions:</p><ol><li>sys_db_object</li><li>sys_db_object.*</li><li>sys_dictionary</li><li>sys_dictionary.*</li><li>sys_glide_object</li></ol></div>
   5. Enter the password for the specified ServiceNow user.
4. Click **Connect**.

   ServiceNow is now connected.

{% hint style="success" %}
**Next Step**: Create a Service Now endpoint. See [ServiceNow Incident Endpoint](https://docs.finout.io/settings/endpoints/servicenow-incident-endpoint-alpha).
{% endhint %}

## FAQs

**How many ServiceNow instances can I connect?**

Only one ServiceNow instance.

**Can I use the integration if I don't create endpoints?**

No, you must have endpoints configured to use the ServiceNow integration.

**What happens if the integration is deleted?**\
\
It will be deleted along with all associated ServiceNow endpoints.

**Why are no fields available for selection in the “Additional Fields” dropdown when creating an endpoint?**

The integration user lacks authorization and requires the following read ACL permissions:

* sys\_db\_object
* sys\_db\_object.\*
* sys\_dictionary
* sys\_dictionary.\*
* sys\_glide\_object

<br>

<br>