Skip to main content
This guide shows you how to register your own OAuth application with ServiceNow to obtain your OAuth credentials (Client ID & Client Secret). These are configured once on the ServiceNow integration in Nango — your users then only need to provide their instance’s domain to connect their account (see How do I link my account?).
1

Create a ServiceNow Developer Account

  1. Go to the ServiceNow Developer Portal.
  2. Click Sign up and Start Building to create a new account if you don’t already have one.
  3. Complete the registration process.
2

Request a Personal Developer Instance (PDI)

  1. After logging in to the Developer Portal, navigate to Start Building.
  2. Click Request Instance.
  3. Select the latest ServiceNow release version.
  4. Wait for your instance to be provisioned (this usually takes a few minutes).
  5. Once provisioned, you’ll receive an email with your instance details, including the URL, admin username, and password.
3

Create an OAuth API endpoint for external clients

  1. Log in to your ServiceNow instance with the admin credentials from your email.
  2. Navigate to System OAuth > Application Registry.
  3. Click New, then select Create an OAuth API endpoint for external clients.
  4. Fill in the following fields:
    • Name: A descriptive name for your application.
    • Redirect URL: https://api.nango.dev/oauth/callback.
  5. Click Submit. ServiceNow auto-generates the Client ID and Client Secret.
4

Configure OAuth scopes

  1. In the Application Registry, open your newly created application.
  2. In the Application Scope tab, click Add.
  3. Search for and select the API scopes your application needs. Common scopes include admin, user_admin, user, useraccount, web_service_admin, web_service, personalize, and user_impersonate.
  4. Click Save.
5

Configure OAuth policies

  1. In your application record, navigate to the OAuth Policies tab.
  2. Configure the token lifespans as needed (defaults: 30-minute access tokens, 100-day refresh tokens).
  3. Set Refresh Token Count to “Unlimited” to allow continuous refreshing.
  4. Click Update.
6

Add your Client ID and Client Secret to Nango

  1. Copy the Client ID and Client Secret from the Application Registry.
  2. In Nango, go to Integrations -> ServiceNow and enter them as the integration’s OAuth credentials.
7

Next

Follow the Quickstart to connect your first account.