ServiceNow Adapter

Need help? Contact us:

 

 

The ServiceNow adapter is designed to provide a template for getting started with ServiceNow API integrations. It leverages the SERVICENOW Library to:

  1. Authenticate with the ServiceNow API via OAuth2.0 (JWT).

  2. Create and retrieve Incident table records in ServiceNow.

This component can be customized and adapted according to your workflow needs. For example, it could be adapted as a Notifications component that integrates Iguana notifications with an existing support workflow. The ServiceNow Rest API Explorer is useful for reviewing the available API endpoints.

Component Setup:

Refer to Set up a ServiceNow Developer Sandbox for the ServiceNow sign up and application set up required in order to gather the authentication details needed for the ServiceNow Adapter.

See Create a Component if this is your first time!

  • Domain: the ServiceNow Instance ID from your developer account, ex. domain.service-now.com.

  • PrivateKey: private key previously generated to be used for signing the JWT.

  • ClientID and ClientSecret supplied by the ServiceNow application endpoint.

  • Kid: the kid (key id) from the JWT Verifier Maps ServiceNow table.

  • UserField: must match what was configured in the JWT (ex. if UserField = Email, this is the user's email address).

Using the information provided, the ServiceNow component will run through the authentication workflow and store the returned access token and expiry time in an encrypted file for use on subsequent API requests.

image-20240417-151435.png
  1. Start the ServiceNow component or open the Translator to run the script. If running the script from the Translator, you will need to set the createTbRecord function call’s live parameter to true for the function to execute when viewing from the Translator

  2. If running the script from within the Translator, you can check the created ticket from the results of the getTbRecord function

  3. In ServiceNow, go to Service Desk > Incidents to see the resulting ticket!

 

Related pages