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

# ServiceNow

Forward Luciq reports into ServiceNow. Authenticate with OAuth 2.0 or with a username and password, pick the caller and assignee, then test before going live.

Luciq supports two ways to authenticate with ServiceNow. If your ServiceNow administrators don't allow password-based access for integrations, use **OAuth 2.0**.

When you create the integration, the wizard's **Authenticate** step shows both options:

* **Basic Authentication** — the username and password of a ServiceNow user. The quickest to set up, and unavailable on instances that block password authentication for integrations.
* **OAuth 2.0** — an OAuth integration you create on your own ServiceNow instance. No password is stored on Luciq, and access tokens are refreshed automatically.

Whichever you pick, the rest of the wizard is the same — see [Set up, test, and finish](#set-up-test-and-finish).

#### OAuth 2.0

ServiceNow has no central app registry: every instance issues its own OAuth credentials. So an administrator creates an OAuth integration on your instance first, then you paste its Client ID and Client Secret into Luciq.

{% hint style="info" %}
Creating the OAuth integration needs the **admin**, **oauth\_admin**, or **mi\_admin** role on your ServiceNow instance.
{% endhint %}

{% stepper %}
{% step %}
**Create an inbound OAuth integration**

In ServiceNow, open **All → Machine Identity Console → Inbound Integrations**, then select **New Integration → OAuth - Authorization code grant**.

On releases before Zurich, the same record lives under **System OAuth → Application Registry → Create an OAuth API endpoint for external clients**.
{% endstep %}

{% step %}
**Fill in the record**

Name the integration (for example `Luciq`) and add this **Redirect URL** exactly as written, including everything after the question mark:

`https://dashboard.luciq.ai/integrations/oauth?provider=servicenow_oauth`

Leave **This is a public client** unchecked — Luciq authenticates with a client secret.
{% endstep %}

{% step %}
**Set the auth scope**

Set **Auth scope** to `useraccount`, which lets Luciq use the Table API as the person who approves the connection.
{% endstep %}

{% step %}
**Copy the credentials**

ServiceNow fills in a **Client ID** and a **Client Secret** on the record. Copy both.
{% endstep %}

{% step %}
**Connect from Luciq**

In your Luciq dashboard, go to **Settings → Integrations → ServiceNow** and switch the toggle to **OAuth 2.0**. Paste the **Client ID** and **Client Secret**, enter your instance URL (for example `https://example.service-now.com`), then select **Authenticate**.

![](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-de9dbcb94ed3bf1bcc7b813be966cdf000c25d1a%2Fservicenow-oauth-authenticate.png?alt=media)
{% endstep %}

{% step %}
**Approve the connection**

ServiceNow opens a window asking to allow Luciq to connect. Sign in as the account the integration should run as, then select **Allow**. The window closes and the wizard moves on.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
Forwarding runs as the account that approved the connection, so that account's roles decide what Luciq can do. It needs Table API access to **incident**, to create the ticket, and to **sys\_user**, to list callers and assignees. An access policy that covers only `incident` passes the connection test and then fails when you choose a caller.
{% endhint %}

To move the integration to a different instance, or to connect as a different account, open the integration and select **Reauthenticate**. The client secret is never shown again after setup, so enter it once more on that screen.

#### Basic Authentication

{% stepper %}
{% step %}
**Enter credentials and URL**

Enter your ServiceNow username, password, and instance URL.

![](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-a15d52c160550a975d399e6763f1e0558c7830ba%2F03031fdcfcb83580de473cfbbdfb8653aaa90a89924edd87a5d6feb8815d58f6%20integrations%20servicenow%201.png?alt=media)
{% endstep %}
{% endstepper %}

#### Set up, test, and finish

After authenticating with either method, the wizard takes you through the same final steps:

{% stepper %}
{% step %}
**Select Caller, Assignee, and preview data**

Select the Caller, Assignee, and the data you'd like to be able to preview.

![](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-765dac4f06f4c628e0e3b203868e750dbc88dd47%2F3e83488db9f9cf656f2c8b58e672eec7a3b7ceaca090c0df853c27000b37838a%20integrations%20servicenow%202.png?alt=media)
{% endstep %}

{% step %}
**Test the integration**

At this point, we just need to test your integration so that we're sure everything is working smoothly.

![](https://2991836969-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCha1KrkvNKPdcC0aGvuB%2Fuploads%2Fgit-blob-fd5d0996f7addc2ccd4a81bc55dda56d994b454d%2Fc0ec6bc3931bfb13f62cc03e72dabcf0f75a945b290b5f52507fe235b39f370e%20integrations%20servicenow%203.png?alt=media)
{% endstep %}

{% step %}
**Finish setup**

All done! Your integration is now set-up and ready to go.
{% endstep %}
{% endstepper %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.luciq.ai/product-guides-and-integrations/integrations/servicenow.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.