Skip to content
Last updated:

Connect ServiceNow

Set up the ServiceNow connection that turns incidents into tickets.

The connection is set in Settings → Integrations, by an admin of the environment. The group appears when the environment has the Integrations module.

In Settings → Integrations → ServiceNow, under Connection:

FieldWhat to enter
Instance URL (ServiceNow)Your instance, such as https://acme.service-now.com.
Client ID and Client SecretAn OAuth client with the client credentials grant.
Token URL (OAuth)Usually your instance followed by /oauth_token.do.
  1. Click Save and confirm with your password, and the authenticator code if you use one.
  2. Click Test connection. It gets a token and reads one record from the incident table. Only a successful test activates the credential, and saving it again requires a new test.

Saving or removing credentials is limited to 3 times per hour. The confirmation needs an Integration Mapper password: an admin who signs in with SSO cannot save credentials, so ask us to do it.

Under ServiceNow fields, optionally fill Assignment group, Business service and Caller. They are sent exactly as typed. Use the target table incident.

In Settings → Integrations → General:

  1. Choose ServiceNow as Responsible for incident creation.
  2. Turn on Enable incident creation. When it is off, incidents are recorded only in Integration Mapper.
  3. Adjust the Ticket title template if you want. It accepts {iflowName}, {packageName}, {exceptionClass}, {occurrenceCount} and {tenantName}.
  • Short description: the title template, up to 160 characters.
  • Description: who opened it, the iFlow, package, exception, number of occurrences and signature. This text is written in Portuguese.
  • Correlation ID: an Integration Mapper reference to the signature, so the ticket can be traced back.