Paragon
Search…
ServiceNow

Setup Guide

You can find your ServiceNow app credentials by visiting your ServiceNow Developer Portal.
You'll need the following information to set up your ServiceNow app with Paragon:
  • Client ID
  • Client Secret
  • Permissions Requested
This is an API-only integration - workflow actions for this integration are still in development. You can still connect user accounts, build workflows, and access the API for this integration.

Add the Redirect URL to your ServiceNow app

Paragon provides a redirect URL to send information to your ServiceNow app. To add the redirect URL to your ServiceNow app:
1. Copy the link under "Redirect URL" in your integration settings in Paragon. The Redirect URL is:
1
https://passport.useparagon.com/oauth
Copied!
2. Log into your ServiceNow Developer Portal.
3. Navigate to All > System OAuth > Application Registry and then click New.
4. Click Create an OAuth API endpoint for external clients.
5. Under Redirect URL, paste the Redirect URL provided in Step 1.
Note: You'll need to create a new OAuth API endpoint if you don't already have one
ServiceNow provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your project.

Add your ServiceNow app to Paragon

1. Select ServiceNow from the Integrations Catalog.
2. Under Integrations > Connected Integrations > {YOUR_APP} > Settings, fill out your credentials from the end of Step 1 in their respective sections:
  • Client ID: Found at the end of Step 1.
  • Client Secret: Found at the end of Step 1.
Press the blue "Connect" button to save your credentials.
Note: Leaving the Client ID and Client Secret blank will use Paragon development keys.

Connecting to ServiceNow

Once your users have connected their ServiceNow account, you can use the Paragon SDK to access the ServiceNow API on behalf of connected users.
See the ServiceNow REST API documentation for their full API reference.
Any ServiceNow API endpoints can be accessed with the Paragon SDK as shown in this example.
1
// You can find your project ID in the Overview tab of any Integration
2
3
// Authenticate the user
4
paragon.authenticate(<ProjectId>, <UserToken>);
5
6
// Get incident records
7
await paragon.request("servicenow", "/now/table/incident", {
8
method: "GET",
9
});
10
11
// Create incident records
12
await paragon.request("servicenow", "/now/table/incident", {
13
method: "POST",
14
body: {
15
"short_description":"Test incident creation",
16
"comments":"These are my comments"
17
}
18
});
Copied!

Building ServiceNow workflows

Once your ServiceNow account is connected, you use the ServiceNow Request step to access any of ServiceNow's API endpoints without the authentication piece.
When creating or updating records in ServiceNow, you can reference data from previous steps by typing {{ to invoke the variable menu.