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:

Login to your instance at https://your-instance-id.service-now.com.
Start by clicking on menu item All, then search for oauth, and click Application Registry option:
Then click button New:
Continue by clicking Create an OAuth API endpoint for external clients option:
Move on by naming your OAuth application and entering a Client Secret (or let it be generated automatically).
Finally give it a final touch by increasing the Refresh Token Lifespan value to 315,360,000 (it should last for 10 years):
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