1. Home
  2. Integrations
  3. ServiceNow Bidirectional Integration Guide

ServiceNow Bidirectional Integration Guide

BEFORE YOU BEGIN: Action is required for your existing ServiceNow to VictorOps Integration.
If you are upgrading from an old XML file to the new VictorOps Bidirectional Integration in the ServiceNow App store, you will need to run the following script or reach out to the support team before installation.


VictorOps ServiceNow Bidirectional Integration

No need to interrupt workflows in order to receive and update tickets. The latest VictorOps to ServiceNow bidirectional integration allows you to spend more time working on incidents and less time moving a ticket through the queue. This way, you can quickly respond to an incident, collaborate in real-time and find resolutions faster.

The VictorOps ServiceNow bidirectional integration maintains incident and ticket history but doesn’t distract you during a firefight. Then, you can leverage this detailed incident history to conduct thorough post-incident reviews and ensure on-call incident management gets better over time. Eliminate context-switching by working in a single application, focusing on the issue at hand and spending less time organizing tickets.

Download the VictorOps application within the ServiceNow app store, and you’ll be up and running within minutes!

Automatically Update ServiceNow Tickets from VictorOps

  • Combine real-time incident response functionality with detailed ticket tracking to create a holistic system for on-call incident management
  • Focus on real-time response and collaboration during a firefight and reduce MTTA/MTTR over time by automatically updating ServiceNow tickets from VictorOps
  • Centralize monitoring data, on-call schedules and alerting to improve visibility into infrastructure health and easily keep cross-functional teams informed during incident response
  • Conduct thorough post-incident reviews with complete records of incident history sent from VictorOps to ServiceNow

ServiceNow Versions Supported:

Madrid, New York, Orlando

  • ServiceNow Account: Requires SNOW Administrative Privileges to create the application registry and an Active, “Web Service Access” only user
  • VictorOps Version Required: Enterprise level of Service
  • Need to Know: Currently manual incident creation in VictorOps will not send to SNOW


Enable VictorOps In ServiceNow

Download the VictorOps application within the ServiceNow Store
You will need HI credentials to perform the “GET” from the ServiceNow Store.


The following prompt will show up within Settings, click “Get Started”

After this, the following modal will appear with the information that you will need to input within VictorOps. The “Finish” button will only appear active after you have entered your credentials within VictorOps.

Enable ServiceNow In VictorOps

As an admin, navigate to Settings >> Alert Behavior >> Integrations >> ServiceNow.

Click Enable Integration

enable servicenow in victorops

After this, you will have the opportunity to enter the credentials from your ServiceNow instance as above.


Click Connect to ServiceNowAfter the connection has been made, return to ServiceNow and click “Finish” to finalize authentication.

Incident State Mapping

ServiceNow and VictorOps will stay in sync as determined by the state mapping that you set up within VictorOps. Changing the state in either system means that the opposite system will be updated.

To edit VictorOps incident states after saving, click the Edit Integration button. Here you may also reconfigure your ServiceNow Connection Details.

Incident State Mapping - SNOW VictorOps

Mapping ServiceNow Assignment Groups

Upon validating credentials, you will be able to map VictorOps Escalation Policies to ServiceNow Assignment Groups. This will allow you to update the Assignment Group in ServiceNow when sending an incident from VictorOps or determine where an incident will go when sent from ServiceNow.

When the mapping is set, the ServiceNow Assignment Group field will be updated based on the Escalation Policy being paged. This field will also update when an incident is rerouted to another Escalation Policy. If the incident reroutes to a specific user, the assignment group will be cleared. Updating an assignment group in ServiceNow will not affect paging behavior in VictorOps.

Mapping ServiceNow assignment groups

Select Add Mapping to see available choices.

Add mapping to see available choices

User Mapping

Upon clicking save on the edit integration page or when taking action on an incident, all available users will be synced across the systems based on an email match.

Updating ServiceNow “Assigned To” Field from VictorOps

The Assigned To field in ServiceNow will be populated with the first user to acknowledge an incident. If the VictorOps incident goes back to a triggered state, the next person to acknowledge will populate the field.

Incident Linking

You can click through to the incident in ServiceNow from the incident pane in VictorOps.

When VictorOps Sends an Incident to ServiceNow

An alert rule will need to be created to complete the integration. Navigate to Settings >> Alert Behavior >> Rules Engine.

Add a rule which defines a matching condition to send VictorOps incidents to ServiceNow. For example, to send all critical incidents to ServiceNow, use:
message_type matches CRITICAL using Wildcard
ServiceNow_Integration to new value true

Mapping Fields from VictorOps to ServiceNow

Available Fields

Preconfigured fields that are immediately available are:
close_code, close_notes, work_notes, short_description, description, state, assignment_group, assigned_to, and resolved_by.

All the above fields can be set by the rules engine using the syntax:
Service_NowField_victorops_<field_name>. However, assignment_group, state, work_notes, short_description, description, assigned_to, and resolved_by should automatically be handled by the integration mapping.

Mandatory / Custom Fields

If an incident in ServiceNow requires mandatory fields, these fields may also be added in a rule with the syntax ‘set ServiceNowField_<field_name> to new value <value>‘. To dynamically assign the value based on an alert field in VictorOps, use the syntax ‘${{victorops_field_name}}‘. See field expansion for more tips on dynamic assignment.

Only some out of the box fields are preconfigured with the VictorOps app, so mapping additional fields in ServiceNow requires additional configuration.

  1. In ServiceNow, navigate to ‘x_splu2_victorops_incident_import.list‘ and click ‘New‘.
  2. Click Menu >> Configure >> Form Layout.
  3. Create a new import table field. This will be the field name for use in the rules engine.
    Eg. “VictorOps Custom Field” would end up needing the syntax ServiceNowField_u_VictorOps_Custom_Field on the rule.
  4. Nagivate to ‘Transform Maps‘ Then ‘VictorOps Incident
  5. Scroll to ‘Field Maps‘ and click ‘New
  6. Assign the ‘Source Field‘ the name from step 3 and assign the ‘Target Field‘ the name of the custom field on the incident table.

After the above steps are complete you can use the VictorOps rules engine to supply the field values with the same syntax as before:
‘set ServiceNowField_<field_name> to new value <value>

In the below image, the field value on the VictorOps import table (in ServiceNow) is “victorops_custom_field”.

Note: If you are not using the VictorOps app from the snow store, the syntax to fill in fields with the rules engine is ‘set ServiceNowField_<field_name> to ${{victorops_field_name}}‘.

Set Logic to Send Incidents and Fields to VictorOps

ServiceNow will automatically send the following fields to VictorOps: assigned_to, assignment_group, caller_id, category, description, number, priority, short_description, state, subcategory, sys_id. To include more fields than the above, add custom fields separated by a comma and they will appear in the alert payload within VictorOps.

Use “Incident Rules” to create custom logic that allows you to set logic as to when incidents are sent from ServiceNow to VictorOps automatically.

Manually Send Incidents from ServiceNow to VictorOps

If the incident rules above have not been met, you may still send the incident with required information including assignment group, by clicking the button “Send to VictorOps” to manually send an incident to VictorOps.

If you have any questions please contact VictorOps support.

VictorOps and ServiceNow CMDB

The VictorOps app can interact with the ServiceNow CMDB by setting any cmdb item field which exists on the incidents table. You can interact with these fields by leveraging the VictorOps rules engine and the ServiceNow transform map following the steps under section “Mapping Fields from VictorOps to ServiceNow”

Updated on August 28, 2020

Was this article helpful?

Related Articles