> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow Enterprise OAuth Configuration Connector

export const InlineImage = ({src, alt = '', height = '1.6em'}) => {
  return <img noZoom src={src} alt={alt} style={{
    display: 'inline',
    verticalAlign: 'start',
    height: height,
    margin: '0'
  }} />;
};

## Intro

ServiceNow is a software platform that supports IT service management and automates common business practices. You can combine your ServiceNow data with data from other systems in Domo to see the end-to-end customer experience and fix any issues faster. Get a quick, interactive view of all your data, fully integrated, to help you spend less time gathering data and make faster, better business decisions.

You can connect to your ServiceNow Enterprise OAuth Configuration account in the Data Center. This topic discusses the fields and menus that are specific to the ServiceNow Enterprise OAuth Configuration connector user interface. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

## Prerequisites

To connect to your ServiceNow Enterprise OAuth Configuration account and create a DataSet, you need the following:

* OAuth Configuration
* Instance Name

### How to Create OAuth Configuration in the Domo instance

To create an OAuth configuration:

1. Log into the customer's Domo instance.
2. Navigate to `https://{customerdomain}.domo.com/datacenter/accounts`.
3. Add New OAuth Configuration.
4. Select the **ServiceNow** **OAuth Config** Configuration Type from the drop-down list.
5. Enter the client id and secret generated through an incoming link, described below.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EtHMjR0Dwu423b1z/images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000002lhYD.jpg?fit=max&auto=format&n=EtHMjR0Dwu423b1z&q=85&s=38f0bd4b47f523ce5ccd40aa443fbbc5" style={{width: 969, height: 408}} width="1014" height="427" data-path="images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000002lhYD.jpg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EtHMjR0Dwu423b1z/images/kb/ka0Vq0000004gFB-00N5w00000Ri7BU-0EMVq000003o7nl.jpg?fit=max&auto=format&n=EtHMjR0Dwu423b1z&q=85&s=ba1ae27d9861a04c602f7b8ae75487c9" style={{width: 409, height: 475}} width="646" height="750" data-path="images/kb/ka0Vq0000004gFB-00N5w00000Ri7BU-0EMVq000003o7nl.jpg" />
</Frame>

**Configuring an Incoming Link**

To create an incoming link:

1. Navigate to **Administration** **>** **Applications** **>** **Application links**.
2. Select **Create link**.
3. Select **External application**, and then select **Incoming** as the direction.
4. Complete the details as described in the below sections.

   **Note:** For the **Redirect URL** field, enter this link [https://oauth.domo.com/api/data/v1/oauth/providers/servicenow-enterprise-oauth-configuration/exchange](https://oauth.domo.com/api/data/v1/oauth/providers/servicenow-enterprise-oauth-configuration/exchange "https://oauth.domo.com/api/data/v1/oauth/providers/servicenow-enterprise-oauth-configuration/exchange"),and for the **Permission** field choose ADMIN from the drop-down list.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EtHMjR0Dwu423b1z/images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000003o5Z4.jpg?fit=max&auto=format&n=EtHMjR0Dwu423b1z&q=85&s=7654013496d3ba11091e28c7ea325276" width="975" height="66" data-path="images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000003o5Z4.jpg" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/EtHMjR0Dwu423b1z/images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000003o6Rt.jpg?fit=max&auto=format&n=EtHMjR0Dwu423b1z&q=85&s=dadebdfb94a9080d322a79b5182ec37e" style={{width: 587, height: 495}} width="975" height="821" data-path="images/kb/ka0Vq0000004gBx-00N5w00000Ri7BU-0EMVq000003o6Rt.jpg" />
</Frame>

**View OAuth credentials for an existing link**

If you lose your OAuth credentials, you can use the application link you have created to access at any time.

To view the OAuth credentials:

1. Navigate to
   **Administration > Application links**.
2. Find the application link you’re interested, and select
   **More actions > View credentials**.

## Connecting to Your ServiceNow Enterprise OAuth Configuration Account

This section enumerates the options in the **Credentials** and **Details** panes on the ServiceNow Enterprise OAuth Configuration Connector page. The components of the other panes on this page, **Scheduling**, and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in great detail in [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your ServiceNow Enterprise OAuth Configuration account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> OAuth Configuration </td><td colspan="1" rowspan="1"> OAuth Configurations have service credentials stored by your administrator that automatically log you in, so only your personal OAuth login is required. Your administrator may create and edit configurations in the Data Center, in the Accounts tab. </td></tr><tr><td colspan="1" rowspan="1"> Instance Name </td><td colspan="1" rowspan="1"> Enter the ServiceNow instance name. For example: <a href="https://instance.service-now.com" target="_blank" title="https://instance.service-now.com."> [https://instance.service-now.com](https://instance.service-now.com). </a></td></tr></tbody></table>

Once you have entered valid ServiceNow Enterprise OAuth Configuration credentials, you can use the same account at any time to create a new ServiceNow Enterprise OAuth Configuration DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector Accounts](/s/article/360042926054 "Manage Connector Accounts").

## Details Pane

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the ServiceNow Enterprise OAuth Configuration report you want to run. The following reports are available: </p><p /><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Report Name </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Standard Table </td><td colspan="1" rowspan="1"> Select from a list of standard tables from Service Now. </td></tr><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"> Creates a custom query. It includes the ability to select which fields are returned to the DataSet. </td></tr><tr><td colspan="1" rowspan="1"> Custom Table </td><td colspan="1" rowspan="1"> It provides a custom table name from which to retrieve data. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Table </td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Table </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Incident </td><td colspan="1" rowspan="1"> Retrieves all data from the incident table. </td></tr><tr><td colspan="1" rowspan="1"> Change Request </td><td colspan="1" rowspan="1"> Retrieves all data from the change request table. </td></tr><tr><td colspan="1" rowspan="1"> Problem </td><td colspan="1" rowspan="1"> Retrieves all data from the problem table. </td></tr><tr><td colspan="1" rowspan="1"> User Groups </td><td colspan="1" rowspan="1"> Retrieves all data from the user groups table. </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Retrieves all data from the users table. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Table Name </td><td colspan="1" rowspan="1"> Enter the name of the table for which you want to retrieve the data for. </td></tr><tr><td colspan="1" rowspan="1"> Custom Query </td><td colspan="1" rowspan="1"><p> Enter a custom query in this field. Include query values directly related to sysparm\_query. The fields sysparm\_limit and sysparm\_offset should not be included. If the field sys\_created\_on is included the value should be in the following format: yyyy-MM-dd HH:mm:ss. </p><p><b> Example query: </b><br /> ORDERBYDESCsys\_created\_on^sys\_created\_on>2016-09-25+00:00:00^sys\_created\_on\<2016-09-27+23:59:59 </p><p> For more Information, refer to <a href="http://wiki.servicenow.com/index.php?title=Table_API#Methods" target="_blank" title="here"> here </a>. </p></td></tr><tr><td colspan="1" rowspan="1"> Fields </td><td colspan="1" rowspan="1"><p> Enter a comma separated list of fields to return with this DataSet. </p><p><b> Example field list: </b><br /> parent,sys\_updated\_on,number </p></td></tr><tr><td colspan="1" rowspan="1"> Data Format </td><td colspan="1" rowspan="1"> Select the format which you expect the ServiceNow API Select report date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector will return date fields. If you select String, Domo will not process the date, and return the literal string returned from the ServiceNow API. </td></tr><tr><td colspan="1" rowspan="1"> Duration </td><td colspan="1" rowspan="1"> Select the duration for the report (a Single Date, or a Date Range). </td></tr><tr><td colspan="1" rowspan="1"> Report Date </td><td colspan="1" rowspan="1"> Select report date using relative or specific dates. Relative indicates the number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days back </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data for. Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Start Date </td><td colspan="1" rowspan="1"> Select report start date using relative or specific dates. Relative indicates the number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Start Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days back to start from </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data from (start day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> End Date </td><td colspan="1" rowspan="1"> Select report end date using relative or specific dates. Relative indicates the number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific End Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days back to end at </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data to (end day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](/s/article/360042926274 "Adding a DataSet Using a Connector").
