How to use IBM® App Connect with ServiceNow

ServiceNow is a cloud-based platform that supports service management for all departments of your business, including IT, human resources, facilities, field service, and more.

Availability:

App Connect Enterprise as a Service connector
Local connector in containers (Long Term Support Cycle-3 release) 13.0.7.0-r1 or later
Local connector in containers (Continuous Delivery release)
Local connector in containers (Long Term Support Cycle-2 release)

Supported product and API versions

To find out which product and API versions this connector supports, see Detailed System Requirements on the IBM Support page.

Connecting to ServiceNow

Complete the connection fields that you see in the App Connect Designer Connect > Applications and APIs page or flow editor. If necessary, work with your ServiceNow administrator to obtain these values.

To connect App Connect to a ServiceNow account, select your preferred authorization method:

Provide a username, password, and client credentials (OAUTH 2.0 PASSWORD)
Provide credentials for App Connect to use (BASIC)

Then, specify values in the connection fields for your chosen authorization method:

Table 1. Connection fields for your chosen authorization method. Descriptions of the connection fields are given after this table.
Provide a username, password, and client credentials (OAUTH 2.0 PASSWORD)	Provide credentials for App Connect to use (BASIC)
Username	Username
Password	Password
Client ID	Endpoint URL
Client secret
Endpoint URL

You must obtain the values for the following connection fields.

Endpoint URL: The URL of the ServiceNow instance that App Connect connects to, in the format https://<servicenow-id>.service-now.com
User name and User password: The username and password that App Connect uses to connect to the ServiceNow instance.
Note: The Endpoint URL and this username and password are for the ServiceNow instance that App Connect connects to. For example, if you're using a Developer instance, the endpoint URL, username, and password are assigned when the instance is created. These values are different from the username and password that you use to sign in to the Developer site.

This user must be assigned the itil and soap roles to allow access to the features and capabilities that App Connect needs. Your ServiceNow administrator can assign these roles to your user account.

Note: If you're using a ServiceNow personal developer instance and access your instance by using the default admin account for the System Administrator profile, you already have the correct access. This account is automatically assigned the admin role, which provides access to all features and capabilities.
Client ID and Client secret: An automatically generated client ID and a client secret (which is user-specified, or can be auto-generated if the field is empty). For information about obtaining a client ID and client secret, see Create an endpoint for clients to access the instance in the ServiceNow documentation. You can copy and paste the client ID and client secret values into App Connect when prompted.
Tip: You can use the ServiceNow Application Registries screen to select an OAuth client application and copy its client ID and client secret values. You can also use this screen to create a new OAuth client application for use with App Connect. To go to this screen, type oauth in the filter navigator, then click Application Registry > New > Create an OAuth API endpoint for external clients.

To connect to a ServiceNow endpoint from the App Connect Designer Applications and APIs page for the first time, expand ServiceNow, then click Connect.

The following example shows completed connection fields for a ServiceNow connector. Example of completed fields for connecting from App Connect

Tip:

Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.

Accessing ServiceNow custom objects

To access more than the static objects that are provided by App Connect (as listed in Events and actions), the user that App Connect uses to connect to the ServiceNow instance must have the soap_query role. Users with this role can access ServiceNow custom properties for any object. Your ServiceNow administrator can assign roles to the user that App Connect uses to connect to the ServiceNow instance.

The following roles are provided for specific functions.

Table 2.
Role	Description
`incident_manager`	Manages incident properties and major incident trigger rules. This role is needed to retrieve incident records for a user and to run create, retrieve, update, and delete operations for the Ticket object.
`knowledge`	Creates, updates, and reviews knowledge base articles. For more information, see Accessing and configuring the Knowledge object.
`knowledge_admin`	Manages the knowledge base. For more information, see Accessing and configuring the Knowledge object.
`personalize_dictionary`	To configure dictionary entries and labels.
`personalize_choices`	To configure choices and predefined responses for nonjournal fields that are designated as choice or suggestion fields.

You can also create a custom role with access to particular tables to access custom properties for specific tables.

Create a custom role.

In a web browser, log in to your ServiceNow instance with an ID that has administration access (or ask your ServiceNow administrator to do the following steps for you).
In the filter navigator field of your ServiceNow instance, type Roles and then select Roles when it is displayed.
Click New.

Update the fields as follows.

Table 3. Custom role values
Field	Value
Name	`custom_role_read_only`
Requires Subscription	Unspecified
Description	`This role is for read access to the following: object - sys_dictionary, sys_db_object and sys_choice`
Application	Global
Elevated privilege	Don't enter a value

Click Submit.

Provide access to tables.

To get permission to modify the Access Control List, click System Administrator > Elevate role.
In the Elevate Roles pop-up window, select security_admin > OK.
In the Filter navigator field, type ACL and then select Access Control (ACL).
In the Access Controls window, New.

For the purposes of this example, the following tables are used:

Table [sys_db_object]
Choice [sys_choice]
Dictionary Entry [sys_dictionary]

To create access controls for these tables, update the fields as follows.

Note: You need to create a record for each table.

Table 4. ACL configuration
Access control fields	Value
Type	`record`
Operation	`read`
Admin overrides	`True` (checkbox)
Name	`Table [sys_db_object]` Tip: Click the name field and type `sys_` in the search field to find the entry.
None	`*`
Application	`Global`
Active	`True` (checkbox)
Role	`custom_role_read_only`. Tip: To add this role, double-click the Insert a new row field and then click the green tick.

Click Submit.
In the 'Verify Security Rules for "sys_xx_xx" ' pop-up window, click Continue.
Repeat steps 2.d - 2.g to create a record for sys_choice and sys_dictionary.

Assign the custom role to a user.
1. In the Filter navigation panel, go to User Administration > Users and select the user you want to work with.
2. In the Roles tab, click Edit.
3. In the Collection list, type custom_role_read_only, select it when it is displayed and then click Add > Save.
4. The user is now ready to access custom objects when they connect to ServiceNow in App Connect.

Accessing and configuring the Knowledge object

You can create, update, and delete knowledge management articles with the ServiceNow knowledge object in App Connect.

The ServiceNow knowledge object and actions in App Connect — Figure 1. The ServiceNow knowledge objects and actions in App Connect

ServiceNow knowledge articles provide user information such as policy, release notes, and instructions for tasks. To access the knowledge object, you must be assigned the knowledge_admin user role in your ServiceNow instance. To assign this user role, complete the following steps.

In a web browser, log in to your ServiceNow instance with an ID that has administration access (or ask your ServiceNow administrator to do the following steps for you).
In the Filter navigation panel, go to User Administration > Users and select the user you want to work with.
In the Roles tab, click Edit.
In the Collection list, select knowledge_admin, and then click Add > Save.

To use the Get additional knowledge metadata and Download knowledge article attachment action nodes in App Connect, you need to have the Knowledge API plug-in installed in your ServiceNow instance. To install this plug-in, complete the following steps.

In a web browser, log in to your ServiceNow instance with an ID that has administration access (or ask your ServiceNow administrator to do the following steps for you).
Go to System Definition > Plugins.
Search for Knowledge API.
When the result is displayed, click Install.

General considerations for using ServiceNow in App Connect

Before you use App Connect Designer with ServiceNow, take note of the following considerations:

(General consideration) You can see lists of the trigger events and actions that are available on the Applications and APIs page of the App Connect Designer.
For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
(General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.

Events and actions

ServiceNow events

These events are for changes in this application that trigger a flow to start completing the actions in the flow.

Note: In containers, only local accounts can be used for these events.

Object	Event	Description
Asset	New asset	A new asset is added to the catalog
Asset	Updated asset	An updated asset is added to the catalog
Attachment	New attachment	A new attachment is added
Comments	New comment	A new comment is added
Department	New department	A new department is added to the catalog
Department	Updated department	An updated department is added to the catalog
Incident	New incident	A new incident is added to the catalog
Incident	Updated incident	An updated incident is added to the catalog
Problem	New problem	A new problem is added to the catalog
Problem	Updated problem	An updated problem is added to the catalog
System user	New system user	A new system user is added to the catalog
System user	Updated system user	An updated system user is added to the catalog
Ticket	New ticket	A new ticket is added to the catalog
Ticket	Updated ticket	An updated ticket is added to the catalog

ServiceNow actions

Your flow completes these actions on this application.

Object	Action	Description
Asset	Create asset	Creates an asset in ServiceNow
	Delete assets	Deletes assets from ServiceNow
	Retrieve assets	Retrieves assets from ServiceNow
	Update assets	Updates assets in ServiceNow
	Update or create asset	Updates or creates an asset in ServiceNow
Attachment	Create attachment	Creates an attachment in ServiceNow
	Delete attachment	Deletes an attachment from ServiceNow
	Download File Attachment Content	Downloads a file attachment content from ServiceNow
	Retrieve attachments	Retrieves attachments from ServiceNow
Comments	Create comment	Creates a comment in ServiceNow
	Delete comment	Deletes a comment from ServiceNow
	Retrieve comments	Retrieves comments from ServiceNow
	Update comment	Updates a comments in ServiceNow
	Update or create comment	Updates or create a comment in ServiceNow
Department	Create department	Creates a department in ServiceNow
	Delete departments	Deletes departments from ServiceNow
	Retrieve departments	Retrieves departments from ServiceNow
	Update department	Updates a department in ServiceNow
	Update or create department	Updates or creates a department in ServiceNow
Incident	Create incident	Creates an incident in ServiceNow
	Delete incidents	Deletes incidents from ServiceNow
	Retrieve incidents	Retrieves incidents from ServiceNow
	Update incident	Updates an incident in ServiceNow
	Update or create incident	Updates or creates an incident in ServiceNow
Knowledge	Create knowledge	Creates a knowledge in ServiceNow
	Delete knowledge	Deletes knowledge from ServiceNow
	Download knowledge article attachment	Downloads a knowledge article attachment or embedded content
	Get additional knowledge metadata	Get additional knowledge metadata from ServiceNow
	Retrieve knowledge	Retrieve knowledge from ServiceNow
	Update knowledge	Updates knowledge in ServiceNow
	Update or create knowledge	Updates or creates knowledge in ServiceNow
Problem	Create problem	Creates a problem in ServiceNow
	Delete problems	Deletes problems from ServiceNow
	Retrieve problems	Retrieves problems from ServiceNow
	Update problem	Updates a problem in ServiceNow
	Update or create problem	Updates or creates a problem in ServiceNow
System user	Create system user	Creates a system user in ServiceNow
	Delete system users	Deletes system users from ServiceNow
	Retrieve system users	Retrieves system users from ServiceNow
	Update system user	Updates a system user in ServiceNow
	Update system users	Updates system users in ServiceNow
	Update or create system user	Updates or creates a system user in ServiceNow
Ticket	Create ticket	Creates a ticket in ServiceNow
	Delete tickets	Deletes tickets from ServiceNow
	Retrieve tickets	Retrieves tickets from ServiceNow
	Update ticket	Updates a ticket in ServiceNow
	Update or create ticket	Updates or creates a ticket in ServiceNow

More items are available after you connect App Connect to ServiceNow.

Examples

Dashboard tile for a template that uses ServiceNow

Use templates to quickly create flows for ServiceNow

Learn how to use App Connect templates to quickly create flows that complete actions on ServiceNow. For example, go to the Discover page and search for ServiceNow.

Learn more

Model Context Protocol (MCP) support

The ServiceNow connector supports MCP, and all ServiceNow actions for the listed objects can be added to an MCP server as tools. For more information on how to configure an MCP server, see Creating and managing MCP servers.

Troubleshooting

ServiceNow personal developer instances go into hibernation and are later reclaimed after a certain period of developer inactivity. If your flows include one or more ServiceNow events or actions, and your ServiceNow instance is hibernating, the connection between App Connect and ServiceNow might be lost. If you see a related message in your App Connect flow, you can reestablish the connection in one of the following ways.

If your instance is in hibernation, either extend your instance, or log in to the ServiceNow console and generate some developer activity.
If your instance was reclaimed, use another instance and connect App Connect to that instance.