---
title: ServiceNow connector
slug: neurons/help/en_us/servicenow-connector
createdAt: 2026-11-05T08:02:10.738Z
---

:::hint{type="info"}
This connector can be run in the cloud or using an on-premises connector server.
:::

The ServiceNow connector gathers data about users, devices, and related incidents from ServiceNow.

Your ServiceNow account must have the following permissions to import data into Ivanti Neurons: `ITIL, Cmdb_read, snc_read-only, and snc_platform_rest_api-access`.

To perform actions in ServiceNow from Neurons (that you set up under Action Credentials below), use an Administrator account.

For information about what data is imported and how it is mapped, see [Mapping](https://docs.ivanti.com/neurons/help/en_us/servicenow-connector#mapping) (below).

## Options

A ServiceNow connector has the following options:

- **Connector name**: A name for the connector.
- **Connector server name**: The name of the connector server that this connector is associated with. When running the connector in the cloud, this server needs to be the **Cloud** option in the list.
  Each connector can only be associated with one connector server. If you added this connector to a specific connector server (on the Connectors > Connector Servers page), this field will be populated for you. Otherwise, you can select the server from the list.
- **On-Premises** or **Cloud** instance: Select **On-Premises** if you are hosting the ServiceNow server in your own environment, or **Cloud** if it is being hosted in the cloud.
- **ServiceNow URL or server name**: The URL or server name for your instance of ServiceNow.
- **Username** and **Password**: Credentials to access ServiceNow.
- **Stale threshold**: To limit the amount of data that is gathered for Neurons, set a threshold for a specific number of days. The connector will import devices and users that have checked in or changed during that time. The minimum number of days is one, and the maximum number of days is 5000.
- **Repeats**: How often the connector should gather data.
- **Start time**: The time of day the connector should start running. To minimize the impact on your network and applications, we recommend that connectors generally run at night or on weekends.
- **Active**: Whether the connector is active or not. While the connector is active, it runs according to the schedule you create. If you clear the check box, the connector is inactive and will not gather data until the check box is enabled again and the connector is saved.
- **Authentication**:
  - **Basic Authentication**: Enter **Username** and **Password** to access ServiceNow.
  - **OAuth Authentication**: Enter **Client ID** and **Client Secret** to access ServiceNow.

For details on configuring or using connectors, see [Connectors](https://docs.ivanti.com/neurons/help/en_us/1001).

## Mapping

The data that this connector imports is mapped to target attributes in the Neurons database.

For an overview of how the data imported by this connector is mapped to the Neurons target attributes, please download the CSV file using the button below.

[Download mappings](<ConnectorCSVs/ServiceNow-Grid view - 2023-10-02.csv>)

For an overview of the Neurons target attributes per data type and the connector source attributes that are mapped to them, see [Connector data mapping](https://docs.ivanti.com/neurons/help/en_us/connector-data-mapping).
