Note:
This legacy integration will be discontinued on March 1, 2026. It is no longer supported by the current platform and will not receive further support, updates, or fixes.
The ServiceNow integration provides you with the ability to view and create ServiceNow Incident tickets. Ticket views can be personalized based on filters, and will only display Incident tickets that a user has ServiceNow permissions to view. Members can select information in the Ticket, Caller, and Assignment Group columns (if displayed) to navigate to the associated page within ServiceNow to view additional details. With the provided search, sort (by clicking column names), and page browsing functionality, users can easily navigate their ticket view. Use this widget to help build a centralized location of information for your organization's teams.
Sections in this article:
- Considerations
- Required actions for your first-time setup
- Set up
- Settings
- Sign in to the ServiceNow integration
Considerations
- Ticket types: The ServiceNow integration only displays and allows users to create Incident tickets.
Required actions for your first-time setup
Before setting up the widget for the first time, you must perform the actions listed below. If you have previously gone through this process while setting up another ServiceNow widget to the same ServiceNow Instance, you do not need to do so again and can reuse the Application ID you already have (You will need a different application ID if you want to use the integration in your preview environment). Once you have completed these steps, you can use the provided Application ID across multiple ServiceNow or Unified Search widgets. If you want to connect a widget to a different ServiceNow Instance, you will need to repeat this process for that instance.
- In the ServiceNow instance: Create a new OAuth Application (OAuth API Endpoint) that will only be used for connections to your Igloo digital workplaces (System OAuth > Application Registry). When setting up this application, update the following fields (other fields can be left in their default state):
- Name: Enter a descriptive name for this OAuth Application.
- Client Secret: Leave this blank. It will generate a random value once the application is created.
-
Logo URL: Enter the URL of your digital workplace logo. For example:
https://{workplace URL}/download.public/logo. - Comments: Enter an explanation of what this Application is being used for.
- Submit a ticket to Igloo Support requesting an Application ID and Redirect URL. In this ticket, include:
- Widget: State that you want to set up the ServiceNow integration Widget.
- Workplace URL: Provide the URL of your digital workplace.
- Client ID: Provide your ServiceNow OAuth Client ID. The Client ID can be found by navigating to System OAuth > Application Registry while in ServiceNow.
- Client Secret: Provide your ServiceNow OAuth Client Secret. This can be found by navigating to System OAuth > Application Registry while in ServiceNow.
- Hosting: Indicate whether your ServiceNow environment is on-premise or cloud-based.
- Enter the Redirect URL that the Igloo Support team provides you into the Redirect URL field of your ServiceNow OAuth Application Endpoint.
Set up
- Place an
Integrations widget on a page, space, or dashboard. For more information, see Placing and setting up a widget.
- Select the placed widget's Edit button.
- Under Integration Library, select Igloo Integration Library.
- Select
ServiceNow from the library.
- Review and make changes to the settings on the Options and Appearance tabs. You can find details about the widget's settings in the Settings section below.
- In the widget editor, select Update to apply your changes.
- At the bottom of your page, space, or dashboard, select Publish or Save as Draft to save your changes.
Settings
Options tab
| Setting | Description |
|---|---|
| Title |
Enter a title for the widget. The title appears as a heading above the widget's contents. You should use the title to provide context to the widget and better structure a page's content by clearly denoting different sections. When entering a title, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select This field can contain a maximum of 140 characters. |
| Title link |
Enter the URL of a location in your digital workplace. Users who click the widget's title, if it has one, will go to this location. Whether you enter the link as a relative URL or an absolute URL does not matter, it will convert to an absolute URL the next time you edit the widget. This field can contain a maximum of 2,083 characters. |
| Description |
Enter a description for the widget. The description appears between the title and the widget's contents. You can use this text to provide information to users about the widget. When entering a description, you do so only for your currently selected language. If your digital workplace supports multiple languages, you should select |
| Setting | Description |
|---|---|
| ServiceNow URL |
Enter the URL of the ServiceNow instance to display in the widget. Only one ServiceNow instance can be configured per widget at a time. This field must contain a valid ServiceNow instance URL or the widget will not function. |
| Application ID |
Enter the Igloo provided Application ID. You must request this ID if you are setting up this widget for the first time, see the Required actions for your first-time setup section above. This Application ID is matched to your ServiceNow URL OAuth Application and can be reused in other ServiceNow widgets that connect to the same ServiceNow instance. This field must contain a valid Application ID or the widget will not function. |
| Tickets |
Select how your users can interact with tickets. You can select:
If you are providing users with a view of existing tickets, they will only be able to view tickets that their ServiceNow permissions would allow them to. |
| Setting | Description |
|---|---|
| Ticket Filters |
Enter a ServiceNow query to display a specific scope of tickets. ServiceNow provides a list of query operators allow you to be more specific which tickets are displayed, allowing you to limit a widget to only display tickets that are relevant for a specific group or team. By default, all tickets that a user has permission to view will be displayed. If the widget only allows the creation of tickets, Ticket Filters should not be configured. |
| Setting | Description |
|---|---|
| Number | Select to display the Number column. |
| Opened At | Select to display the Opened At column. |
| Short Description | Select to display the Short Description column. |
| Caller | Select to display the Caller column. |
| Priority | Select to display the Priority column. |
| State | Select to display the State column. |
| Category | Select to display the Category column. |
| Assignment Group | Select to display the Assignment Group column. |
| Assigned To | Select to display the Assigned To column. |
| Updated On | Select to display the Updated On column. |
| Updated By | Select to display the Updated By column. |
| Additional Columns | Enter the names of other columns to display in the provided Additional Columns field. If you are entering multiple values, separate them with a comma. |
At least one column must be displayed. If the widget only allows the creation of tickets, Ticket Filters should not be configured.
Appearance tab
| Setting | Description |
|---|---|
| Class |
Enter CSS class selectors to provide additional styling to the widget. For more information, see Applying custom CSS to widgets. |
| Height |
Select the height of the widget. Options include:
|
Note
Your digital workplace's theme overwrites many of the settings on the Appearance tab. However, the settings listed above are usable.
Sign in to the ServiceNow integration
You must sign in to the widget to access its functionality. After selecting Sign in, you will be prompted to allow the connection to ServiceNow; select Allow to continue logging in. If you would like to sign in using a different account, select Not You? to enter your credentials manually.