Skip to main content

How to Obtain a ServiceNow OAuth Token for Dispel

Written by Fred
Updated over a year ago

Context: You are using ServiceNow and Dispel, and would like to utilize the Dispel ServiceNow Integration.

Goal: Create an admin user for Dispel within your instance, generate an OAuth Token for said user, and obtain said OAuth Token.

  1. Prerequisites:

    1. Have an Admin account within your ServiceNow instance

  2. Click on “All” in the top left corner

  3. Search “users”

  4. Scroll down to “System Security” → “Users and Groups” → “Users” and click on “Users”

  5. Click “New” in the top right corner

  6. Make sure “password needs reset” is UNCHECKED and “active” is checked

  7. Give your user a User ID and nothing else (Recommended: Give the user the User ID “dispel”), then click “Submit”

  8. This will take you back to the all users page. In the top, search by User ID and search for your new user.

  9. Click on the user.

  10. Click “set password,” then click “generate.”

  11. Save this user ID and password somewhere safe, you will need them later

  12. Click Save Password and close the popup window

  13. At the bottom of the screen, underneath “Related Links,” you will see a table of sorts. Click on the “Roles” tab and then “Edit” button of that table.

  14. Select the following roles, one-by-one, and click on the right-facing arrow to move them from Collections to Roles List. Click save when all 3 roles are in the Roles List.

    1. admin

    2. itil

    3. snc_platform_rest_api_access

  15. Go back to your instance homepage at https://<instance_name>.service-now.com/

  16. Click on “All” in the top left corner

  17. Search for “Application Registry” and select it

  18. Click “New” in the top-right corner

  19. Click “Create an OAuth API endpoint for external clients”

  20. Fill out the fields, give it a name

    1. If you’d like to integrate Dispel with multiple apps, leave “Accessible from” as “All application scopes” — otherwise, select only the desired app

  21. Click Submit

  22. Navigate back to the Application Registry page and select our new OAuth API Endpoint

  23. Leave this page open with the credentials, then send them over to Dispel

  24. Here is what Dispel will need:

    1. <client_id from credentials>

    2. <client_secret from credentials>

    3. Admin username/password combination to authenticate with the instance

Did this answer your question?