Skip to content

Connect ServiceNow

This guide connects a client’s ServiceNow instance to a workspace, so that Raise Ticket appears on every event.

  • The admin role in the workspace.
  • The Super plan, with ITSM ticketing ticked under Policies, in the Feature flags list.
  • A ServiceNow administrator for step 1.

Ask the ServiceNow administrator to do this on the instance.

  1. Check that the instance runs the Washington DC release or newer.
  2. Set the system property glide.oauth.inbound.client.credential.grant_type.enabled to true.
  3. Under System OAuth → Application Registry, create an Application endpoint for external clients. Leave it confidential, not public.
  4. Set an OAuth Application User on the registry record, and give that user the itil role. Incidents are created as this user.
  5. Copy the client ID and the client secret.
  1. Open ITSM under Workspace.
  2. In the ServiceNow connection card, enter the ServiceNow instance URL, for example https://your-instance.service-now.com.
  3. Enter the OAuth client ID and the OAuth client secret.
  4. Optional: enter an Assignment group, as a group name or a sys_id, to send every incident to one queue.
  5. Optional: enter a Caller sys_id.
  6. Tick Enable ticketing.
  7. Choose Save changes.

You see ServiceNow connector saved.

  1. Choose Send test incident.
  2. You see Test incident with a number created in ServiceNow.
  3. In ServiceNow, find the incident titled “Identiguard connection test - no action required” and close it.

Open the dashboard. Raise Ticket is now on each event row in Real-time events. Admins and members can use it. See Raise a ticket.

  1. Open ITSM.
  2. Choose Replace beside the masked client.
  3. Enter the new OAuth client ID and OAuth client secret.
  4. Choose Save changes, then Send test incident.
  1. Open ITSM and change the ServiceNow instance URL.
  2. The credential fields appear again. Enter the client ID and secret for the new instance. The stored client is never sent to a different instance.
  3. Choose Save changes, then Send test incident.
  • To hide Raise Ticket and keep the connector, untick Enable ticketing and choose Save changes.
  • To remove the connector, choose Disconnect, then Disconnect again in the dialog Disconnect ServiceNow? The stored OAuth client is deleted. Incidents already raised are not affected.
What you see What to do
ITSM is not in the sidebar Check that you are an admin, that the plan is Super and that ITSM ticketing is ticked under Policies.
ServiceNow instance URL host is not allowed. The URL must be on service-now.com or servicenowservices.com and use HTTPS.
ServiceNow authentication failed with a status Check the client ID and secret, that the client is confidential, that the system property is true and that an OAuth Application User is set.
A message ending redirects are not followed Use the direct instance URL, not an address that redirects.
ServiceNow assignment group with the name was not found on the instance. Correct the group name, or paste its sys_id.
ServiceNow incident creation failed with a status Usually the OAuth Application User has no itil role, or the caller sys_id is wrong.
Send test incident is disabled Save the connector first.

Every message is explained in ServiceNow ticketing.