ServiceNow

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.

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.

1. Navigate to your instance URL (typically in the format https://[your-instance-name].service-now.com/).
2. Log in with the admin credentials provided in the email.

1. In your ServiceNow instance, navigate to System OAuth > Application Registry.
2. Click New to create a new OAuth application.
3. Select Create an OAuth API endpoint for external clients.
4. Fill in the following fields:
   • Name: Enter a descriptive name for your application.
   • Client ID: This will be auto-generated.
   • Client Secret: This will be auto-generated.
   • Redirect URL: Enter https://api.nango.dev/oauth/callback.
5. Click Submit to create the application.

1. In the Application Registry, find and 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: Full administrative access
   • user_admin: User administration
   • user: Access to user data
   • useraccount: Access to user account data
   • web_service_admin: Web service administration
   • web_service: Access to web services
   • personalize: Personalization capabilities
   • impersonate: Ability to impersonate users
4. Click Save to apply the selected scopes.

1. In your application record, navigate to the OAuth Policies tab.
2. Configure the following settings:
   • Access Token Lifespan: Default is 30 minutes (1800 seconds). You can adjust this as needed.
   • Refresh Token Lifespan: Default is 8 hours (28800 seconds). You can adjust this as needed.
   • Refresh Token Count: Set to “Unlimited” to allow continuous refreshing of tokens.
3. Click Update to save your changes.

1. In the Application Registry, open your application.
2. Note the Client ID and Client Secret values.
3. Also note your instance URL, as you’ll need this for the authorization and token endpoints.

When setting up your ServiceNow integration in Nango:

• Use your Client ID and Client Secret from the previous step
• For the authorization URL, use: https://[your-instance-name].service-now.com/oauth_auth.do
• For the token URL, use: https://[your-instance-name].service-now.com/oauth_token.do
• Replace [your-instance-name] with your actual ServiceNow instance name

Follow the Quickstart.