> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/integrations/servicenow-integration.md).

# ServiceNow Integration

Create ServiceNow incidents from data quality issues detected in Telmai.

Connect your ServiceNow instance to Telmai to track data quality issues as ServiceNow incidents. Telmai can open a ServiceNow incident automatically when a monitor opens a Telmai incident, or you can create one by hand from an incident.

{% hint style="info" %}
Only one ticketing system can be connected at a time: either Jira or ServiceNow. To switch from [Jira](/telmai/integrations/jira-integration.md) to ServiceNow, disconnect Jira first.
{% endhint %}

## Prerequisites

Telmai connects to ServiceNow with OAuth 2.0 using the **client credentials** grant. Before you configure the integration, ask your ServiceNow administrator for:

* An OAuth application registered in your instance's Application Registry that supports the client credentials grant, and its client ID and client secret. The client credentials grant must be allowed for inbound OAuth on the instance.
* The instance URL, for example `https://your-instance.service-now.com`. The instance must be reachable from Telmai over the internet.

Telmai calls the ServiceNow Table API as the user the OAuth application runs as. That user needs these permissions:

| Table            | Access          | Used for                                                          |
| ---------------- | --------------- | ----------------------------------------------------------------- |
| `incident`       | Read and create | Creating incidents and showing their state and assignee in Telmai |
| `sys_dictionary` | Read            | Listing the incident fields you can set in a template             |
| `sys_choice`     | Read            | Listing the values of choice fields, such as urgency or category  |
| `sys_user`       | Read            | Searching users for fields such as **Assigned to**                |
| `sys_user_group` | Read            | Searching groups for fields such as **Assignment group**          |
| `cmdb_ci`        | Read            | Searching configuration items                                     |

## Configuring ServiceNow Integration

Only tenant administrators can configure the ServiceNow integration.

### Connect to ServiceNow

1. Open **Administration** and, under **Integrations**, select **ServiceNow**.
2. Enter the **Instance URL**. Use an `https` URL with the scheme and host only, such as `https://your-instance.service-now.com`, without a path.
3. Enter the **Client ID** and **Client secret** of your ServiceNow OAuth application.
4. Click **Connect**. Telmai checks that it can read the `incident` table with these credentials and saves the connection.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-eecd5538d76a2f688323c8b09449343c1014dc7b%2Fadmin-servicenow-2026-11-04.png?alt=media" alt="The ServiceNow setting in Administration with Instance URL, Client ID, Client secret and Connect"><figcaption><p>Connecting ServiceNow.</p></figcaption></figure>

The top of the setting shows the connection status:

* **ServiceNow is connected to this tenant.** — Telmai can reach the instance with the saved credentials.
* **ServiceNow is connected, but the instance didn't accept the credentials. Update them below.** — the credentials no longer work, for example because the client secret was rotated. Enter new credentials and click **Save connection**.

To change the connection later, edit the fields and click **Save connection**:

* Leave **Client secret** empty to keep the current secret when you update other fields.
* If you change the **Instance URL**, you must enter the client secret again.
* Click **Disconnect** to remove the integration.

### Create ticket templates

A template sets the ServiceNow incident fields Telmai fills in when it creates an incident, such as urgency, category or assignment group. Templates are required for [automatic incident creation](#create-incidents-automatically) and optional when you create an incident manually.

To create a template:

1. In **Administration** > **ServiceNow**, click **New template** under **Ticket templates**. Templates appear once ServiceNow is connected. You can also click **Manage templates** in a monitor's **Create a ticket** step.
2. Enter a **Name**. Names are required, must be unique, and can have up to 20 characters.
3. Optionally, enter a **Description**.
4. Under **Incident fields**, set the fields the incident should have:
   * Fields that are mandatory in your ServiceNow instance are added automatically and can't be removed. Set a value for each of them.
   * Click **Add field** to add another field, choose it from the **ServiceNow field** list, and set its **Value**. Choice fields show the values defined in ServiceNow. Fields that point to users, groups or configuration items let you search for a record.
5. Click **Create**. The template appears in the **Ticket templates** list.

To edit a template, expand its row in the list, change it and click **Save**. To delete it, click the delete icon in the **Actions** column.

{% hint style="info" %}
Telmai generates the incident's short description and description from the detected issue, so these two fields can't be set in a template. If your instance has no other fields Telmai can set, incidents are created with your ServiceNow default values.
{% endhint %}

## Create ServiceNow Incidents

You can create ServiceNow incidents automatically when a monitor opens a Telmai incident, or by hand for an existing incident.

{% hint style="info" %}
Telmai creates ServiceNow incidents and links them to incidents in Telmai. It does not resolve or close the ServiceNow incidents.
{% endhint %}

### Create Incidents Automatically

To have Telmai create a ServiceNow incident whenever a monitor opens a Telmai incident, choose a template in the monitor's ticketing settings:

1. Open the asset's **Monitors** tab and click **View** on the monitor, then **Edit**. For a new monitor, click **New monitor**.
2. In the [Create a ticket](/telmai/monitoring-data/monitors-management/creating-a-monitor.md#step-3-create-a-ticket) step, check **Create ticket automatically** and choose a ServiceNow **Template**.
3. Click **Save**.

To set this for several monitors at once, select them in the monitors list and use the **Ticketing** bulk action.

### Create Incidents Manually

To create a ServiceNow incident for an existing Telmai incident:

1. Open [Incidents](/telmai/monitoring-data/incident-portal.md) from the side menu.
2. Click **Create ticket** in the incident's **Ticket** column, or in the **Metadata** section of the incident's details.
3. In **Create ticket**, choose a **Template (optional)** if you want one. Its field values are added to the dialog, where you can change them.
4. Review the **Summary** and **Description**. Telmai fills them in for you; you can edit both.
5. Click **Create ticket**.

The incident's number then appears in the incident's **Ticket** column and details. To remove the link, use **Unlink ticket** next to it.

{% hint style="info" %}
You can create a ServiceNow incident for a Telmai incident only if the incident is open and has no ticket linked to it yet.
{% endhint %}

## Related Documentation

* [Jira Integration](/telmai/integrations/jira-integration.md)
* [Creating a Monitor](/telmai/monitoring-data/monitors-management/creating-a-monitor.md)
* [Monitors Management](/telmai/monitoring-data/monitors-management.md)
* [Incident Portal](/telmai/monitoring-data/incident-portal.md)
