Overview

This guide will walk you through how to create an Inbound Integration OAuth app in ServiceNow and enter your OAuth credentials in Merge.

Instructions

Step 1: Create an Inbound Integration OAuth app

1. Log into ServiceNow. Click All in the top left corner, and search for Application Registry in the drop down menu.

2. Within the Application Registries page, select New to begin the app creation flow.

3. Select New Inbound Integration Experience.

4. In the Inbound Integrations page, select New integration.

4. Within the Select your application connection type window, proceed with OAuth - Authorization code grant.

4. Enter a name for the App and input the Redirect URL as https://ah.merge.dev/oauth/callback.

5. Copy the Client ID. You'll need this later.

6. Select box for This is a public client, which initiates the PKCE flow.

Step 2: Enable OAuth settings

1. In the Auth scopes area of the page, configure your Auth scopes. Your options are either:

   1. The default useraccount scope. This grants the integration permission to whatever the authenticated user can access and perform.

   2. Configure a custom auth scope to limit access to read-only, write-only, etc. The below guide has more detail on that process.

      1. 📄 ServiceNow - What options do I have for scopes?

2. Navigate back to the top of the page and select Save.

3. Enter the previously copied values for Client ID into the Merge Dashboard.