Configure ServiceNow Integration

Last Updated: June 12, 2026

Use this procedure to connect PrinterLogic to your ServiceNow instance. After you configure the integration, printer asset data syncs automatically from PrinterLogic to your ServiceNow Configuration Management Database (CMDB).

Requirements

Before you begin, confirm the following:

You have access to the PrinterLogic Admin Console.
You have your ServiceNow instance URL.
You have OAuth credentials or API credentials with the appropriate RBAC role in ServiceNow to authorize the integration.
SNMP is configured on your printers, or serial numbers are available to enter manually.

Before you begin, confirm the following: You have sysadmin-level access to your ServiceNow instance.

Configure ServiceNow

Before PrinterLogic can connect to ServiceNow, you must configure your ServiceNow instance to accept the integration.

Step 1: Enable the Client Credentials Grant System Property

Select All in the upper-left to open the ServiceNow search navigator.
Enter sys_properties.list in the search bar, then press Enter.

Search for the following property:

Copy Code

glide.oauth.inbound.client.credential.grant_type.enabled

If the property exists, confirm the Value is set to true, and Type is set to true | false.
1. If the property does not exist:
  1. Select New and enter the following values:
  2. Name: glide.oauth.inbound.client.credential.grant_type.enabled.
  3. Type: true | false.
  4. Value: true.
2. Select Save.

A missing or false value causes a 400 error when PrinterLogic attempts to connect.

2. Create Integration User

In the ServiceNow navigator, go to User Administration > Users.
Select New and enter the following values:
1. UserID: Vasion Integration, or unique name.
2. First Name: Vasion.
3. Last Name: Integration.
4. Identity Type: Machine.
5. Active: Selected.
6. Internal Integration User: Selected.
Select Submit.
Scroll to the Roles related list at the bottom of the user record and select Edit.
Search for and add the following roles:
1. asset: CMDB read and write access.
2. itil: Required for the Identification & Reconciliation (I&R) API.
3. oauth_user: Allows the user to authenticate using OAuth.
Select Save.

3. Create the OAuth Application

In the ServiceNow navigator, search for and select Inbound Integrations.
Select New Integration.
In the Select your application connection type modal, select OAuth - Client credentials grant.
Enter the following values:
1. Name: Vasion Integration, or unique name.
2. Provider Name: Vasion.
3. OAuth Application User: UserID from the integration user created in step 2.
4. Active: Selected.
Scroll to the Auth scope section and confirm Allow access only to APIs in selected scope is selected.
Select Create auth scope and name it vasion_print_integration, then select Save.
In the Configure auth scopes section, select the Limit authorization to the following APIs field and:
1. Type and select Table API. This API queries manufacturers and models.
2. Type and select Identification and Reconciliation API. This API pushes printer data into the CMDB.
If Allow access only to APIs in selected scope is selected with no scopes configured, all API calls are blocked.
(Optional) In Advanced Options, confirm or adjust the following:
1. Access Token Lifespan: 1800 (30 minutes, the default)
2. Token Format: Opaque
PrinterLogic automatically requests a new token when the current one expires, so any lifespan value works.
Select Save.

Note the Client ID and Client Secret displayed on the saved record. You need these values in step 6.

4. Register Discovery Source

Every sync request PrinterLogic sends includes the parameter sysparm_data_source=Vasion_Print. You must register this value in ServiceNow before the first sync.

In the browser address bar, append the following path to your ServiceNow instance URL and press Enter:
Copy Code
```
/sys_dictionary.do?sysparm_query=name=cmdb_ci%5Eelement=discovery_source
```
Example: https://your-instance.service-now.com/sys_dictionary.do?sysparm_query=name=cmdb_ci%5Eelement=discovery_source
Select the Choices tab further down the page, then select New and enter the following values:
1. Element: discovery_source (confirm auto-populated).
2. Label: Vasion_Print.
3. Value: Vasion_Print.
Select Submit.

The Label and Value must exactly match the Data Source Name you enter in step 7, including capitalization. A mismatch causes the I&R API to reject all incoming payloads.

5. Verify CI Identification Rules and Add Related Attributes

In the ServiceNow navigator, search for and select CI Identifiers.
Select New, and give the new record a name.
Search for and select Printers in the Applies to dropdown.
Confirm the Active and Independent options enabled, then select Submit.
Search for and select your identifier app again.
In the Identifier Entries tab, select New and:
1. In the Search on table dropdown, search for and select Printer.
2. Select Criterion attributes.
3. Move Serial number to the Selected column.
4. Set the priority to 100.
5. Select Active.
6. Select Submit.
Use the New button in the Identifier Entries tab to add any additional validation identifiers.

Vasion recommends adding at least Serial number and Asset Tag. If neither field matches an existing record, ServiceNow creates a new cmdb_ci_printer entry.
After adding your Identifier Entries, select the Related Entries tab.
Select New, then:
1. Search for and select Key Value in the Related table dropdown.
2. Select Configuration item in the Referenced Field dropdown.
3. Adjust the priority as needed, then select Submit.

This related entry enables Vasion to sync extended printer attributes, such as port, location, color support, and duplex support, as key-value tags on the printer record in the ServiceNow CMDB.

6. Add Printer Tags (Optional)

If you need to add additional printer tags to sync:

Search for and select Printers.
Select the desired printer.
From the side menu, select Configure, then Related Lists.
Locate the desired tags, select, and use the arrows to move them to the Selected column.
Select Save when finished.

These printer tags now show as tabs under the printer information.

7. Connect Vasion to ServiceNow

In the PrinterLogic Admin Console, go to Admin Integrations .
Select the ServiceNow integration.
Enter the following values:
1. ServiceNow Instance URL: e.g., https://your-instance.service-now.com.
2. Description (Optional): A label for your reference.
3. Client ID: The Client ID from step 3.
4. Client Secret: The Client Secret from step 3.
5. Data Source Name: Vasion_Print (recommended)
The Data Source Name must exactly match the value you registered in step 4, including capitalization.
Select Connect to connect and proceed.
In the Add Fields tab, select the Identifier Field(s). Serial Number or Custom field.

If you want to use a different field for the identifier, it must be a custom printer field with a value for each printer object.
Use the Additional Fields (Optional) to add more fields to sync.
Select Next to proceed.
On the Transfer Data tab, adjust the Manual Sync options as needed.
1. Transfer only changes: Transfer only data that has changed since the last sync.
2. Transfer all data: Transfer all data regardless of whether it has changed since the last sync.
Select Sync Now, or Test, to test the sync first.
Select Save.

After the connection is saved, the ServiceNow integration appears in the Added Integrations section of the Integrations page.

Sync Printers

The first release of the ServiceNow, syncs happen manually, with automatic syncs coming in a later release.

To manually sync printers:

In the Vasion Admin Console, go to Admin Integrations .
Select the more icon for the ServiceNow integration, then select Settings.
Select the Transfer Data tab.
Select Sync Now.

Allow time for printers to sync. Beneath the Sync Now button, the sync history displays.

In this topic: