ServiceNow Connector
Documentation
Version: 2
Documentation
Authentication

OAuth


Description

Authenticate using ServiceNow instance username, password, OAuth Client ID, and Client Secret. [API reference]

Instructions

Create OAuth application and use it for authentication:

  1. Login to your instance at https://your-instance-id.service-now.com.
  2. Start by clicking on menu item All, then search for oauth, and click Application Registry option:

    Locate OAuth configuration in ServiceNow
  3. Then click button New:

    Create new OAuth application in ServiceNow
  4. Continue by clicking Create an OAuth API endpoint for external clients option:

    Use ServiceNow OAuth application for external clients
  5. Move on by naming your OAuth application and entering a Client Secret (or let it be generated automatically).

  6. Finally give it a final touch by increasing the Refresh Token Lifespan value to 315,360,000 (it should last for 10 years):

    Configure OAuth application in ServiceNow
  7. Done! Now you can use Client ID and Client Secret when configuring OAuth Authentication parameters.

Parameters

Parameter Required Default value Options
Name: InstanceName

Label: InstanceName

YES
Name: UserName

Label: User name

You can create new user account and set password here https://{your-instance-id}.service-now.com/now/nav/ui/classic/params/target/sys_user.do or visit All \ Organization \ Users in the portal
YES
Name: Password

Label: Password

You can create new user account and set password here https://{your-instance-id}.service-now.com/now/nav/ui/classic/params/target/sys_user.do or visit All \ Organization \ Users in the portal
YES
Name: ClientId

Label: Client ID

YES
Name: ClientSecret

Label: Client Secret

YES
Name: ApiVersion

Label: ApiVersion

YES v2
Name Value
Default
v2 v2
v1 v1
Name: RetryMode

Label: RetryMode

RetryWhenStatusCodeMatch
Name Value
None None
RetryAny RetryAny
RetryWhenStatusCodeMatch RetryWhenStatusCodeMatch
Name: RetryStatusCodeList

Label: RetryStatusCodeList

429|503
Name: RetryCountMax

Label: RetryCountMax

5
Name: RetryMultiplyWaitTime

Label: RetryMultiplyWaitTime

True