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

# ServiceNow Knowledge Base

The ServiceNow Knowledge Base integration lets you connect your ServiceNow instance to Harmony so that your AI agents can draw on published ServiceNow articles when answering customer questions. Once connected, Harmony automatically syncs your published content and keeps it up to date, so your agents always have access to the latest information without any manual effort.

This integration works alongside other knowledge base sources you may already have configured, such as Confluence, Notion, and SharePoint, and is available to all accounts.

### Authentication Methods

Harmony reads your ServiceNow knowledge base through your ServiceNow connection, which you set up once in **Settings** > **Integrations** under **IT Service Management**. There are two ways to connect. Choose the one that matches your organization's setup:

* **ServiceNow (OAuth)** - you create an OAuth application in your ServiceNow instance and authorize Harmony through it
* **ServiceNow (Service Account)** - you enter the username and password of a ServiceNow service account

If ServiceNow is already connected for ticket sync, there is nothing more to connect: Harmony syncs your knowledge articles through that same connection.

### Prerequisites

Before setting up the integration, make sure you have the following:

* A ServiceNow instance with at least one published knowledge base
* A ServiceNow account that can read your knowledge articles. ServiceNow sets read access with the user criteria (**Can Read**) on each knowledge base and article, so Harmony syncs only the articles this account can read. For OAuth, the setup wizard's **Knowledge base** check names the `knowledge` role
* Your ServiceNow instance URL (for example, `https://your-instance.service-now.com`)
* Credentials ready for your chosen method: an OAuth application in your ServiceNow instance, or a service account username and password

### Connecting ServiceNow to Harmony

#### Step 1 - Open the Integrations page

1. Log in to your Harmony account.
2. Go to **Settings** > **Integrations**.
3. Under **IT Service Management**, click the **ServiceNow (OAuth)** or **ServiceNow (Service Account)** card.

#### Step 2 - Enter your ServiceNow instance details

1. Enter your ServiceNow instance URL in **Instance URL**.

#### Step 3 - Authenticate with OAuth

If you chose **ServiceNow (OAuth)**:

1. Follow the setup wizard: create an OAuth API endpoint in your instance's **Application Registry**, enter its **Client ID** and **Client Secret**, click **Connect** and sign in to your instance to grant access. See [ServiceNow](https://docs.harmony.io/integrations/it-service-management/servicenow.md) for the full walkthrough.
2. When the wizard validates capabilities, keep **Knowledge base** selected so Harmony checks that the account can read knowledge articles.

#### Step 3 - Authenticate with a service account

If you chose **ServiceNow (Service Account)**:

1. Enter the **Username** and **Password** for the ServiceNow account Harmony will use to access your knowledge base. Harmony validates the credentials by reading your instance's incident table, so the service account also needs the roles listed in [ServiceNow](https://docs.harmony.io/integrations/it-service-management/servicenow.md).
2. Click **Connect**.

#### Step 4 - Choose which articles to index

Once connected, Harmony begins syncing your published articles. Depending on the size of your knowledge base, the initial sync may take a few minutes to complete. The articles appear in your **Knowledge Base**, and you choose which ones your agents use. See [Managing your Knowledge Base](https://github.com/harmonyso/public-docs/tree/main/guides/managing-knowledge-base/managing-knowledge-base.md) for the selection workflow.

### How Syncing Works

Once the integration is active, Harmony automatically keeps your content up to date. Here is what to expect:

* Only **published** articles are synced. Draft or retired articles are not included.
* Harmony periodically checks your ServiceNow instance for new or updated content and reflects those changes across your support workflows.
* You do not need to manually trigger a sync after publishing updates in ServiceNow.

### Using ServiceNow Content with AI Agents

After the sync completes, your AI agents can reference ServiceNow articles when responding to customer questions, just as they would with content from any other connected knowledge base source. No additional configuration is required to make the content available to your agents.

If you have multiple knowledge base sources connected, Harmony draws from all of them to provide the most relevant and accurate answers.

### Disconnecting the Integration

The knowledge base sync uses your ServiceNow connection, so it stops only when that connection is removed. Disconnecting also stops ticket sync with ServiceNow.

1. Go to **Settings** > **Integrations** and click your connected **ServiceNow (OAuth)** or **ServiceNow (Service Account)** card.
2. Click **Disconnect**.
3. Confirm the disconnection when prompted.

Once disconnected, Harmony will stop syncing content from ServiceNow, and your agents will no longer have access to those articles.

### Troubleshooting

**Harmony is not syncing articles after connecting**

* Verify that the credentials or OAuth authorization you provided are still valid in ServiceNow.
* Confirm that the articles you expect to see are in a **Published** state in ServiceNow.
* Check that the ServiceNow account used for the connection has read access to the relevant knowledge bases.

**Connection fails during setup**

* Double-check your ServiceNow instance URL for typos. It should follow the format `https://your-instance.service-now.com`.
* For OAuth, check that the Redirect URL of the OAuth API endpoint in ServiceNow matches the one shown in the Harmony setup wizard, and that the Client ID and Client Secret were copied correctly.
* For a service account, confirm the username and password are correct and that the account is active.

**Articles are missing after sync**

* Confirm the missing articles are published and active, and that the ServiceNow account used for the connection can read them.
* In your **Knowledge Base**, check that the missing articles are selected for indexing.

If you continue to experience issues, contact Harmony Support for assistance.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.harmony.io/integrations/knowledge-base/servicenow-knowledge-base.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
