Introduction

To enable the ServiceNow Incident Management connector, you need an username and password tied to an account.

See the schema reference for ServiceNow Incident Management >

Steps to connect

Step 1 can be skipped if the user has already created or plans to use the admin username and password.

Step 1

Log in to your ServiceNow account and navigate to Organization > Users. Click on 'New' and fill out user details including setting a password.

Go to the 'Roles' tab, click 'Edit,' and ensure the user has the 'Incident Manager' , 'Service Admin' and 'User Admin' permissions.

To use Basic Authentication, proceed to the next step. Otherwise, to set up OAuth authentication, go to Application Registry and create an OAuth API endpoint for external clients. You can obtain the Client ID and Client Secret from there.

Step 2

Navigate to the Data Cloud > Connections screen within DX, then add a connection using your credentials generated in the previous steps.

Configure the ServiceNow API Base URL to match your instance's URL, for example: https://dev214869.service-now.com

API Reference

Endpoint	Documentation Link
/table/incident	ServiceNow API: List Incidents
/table/cmdb_ci_service	ServiceNow API: Get Services
/table/sys_user_group	ServiceNow API: Groups
/table/sys_user	ServiceNow API: List Users

Errors

This table lists error codes that you may encounter when adding a connection in DX.

Error	Description
`invalid_credentials`	Your API credentials entered are not valid.
`invalid_permissions`	Your API token does not have the permissions required by DX.