> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bondata.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ServiceNow

> Connect BonData to ServiceNow for ITSM and CMDB data

ServiceNow is a cloud platform for IT service management (ITSM), operations, and workflow automation across the enterprise. With BonData, you can connect to your ServiceNow account to read, enrich, and sync your ITSM and CMDB data within Agent workflows.

## ServiceNow Authentication Setup

BonData connects to ServiceNow through the Table API. You can authenticate with Basic auth or OAuth 2.0.

### Step 1: Find Your Instance URL

Your instance URL is the address you use to log in, in the format:

* `https://yourcompany.service-now.com`

### Step 2: Choose an Authentication Method

<Tabs>
  <Tab title="Basic Auth (Quick Setup)">
    1. Log in to ServiceNow as an administrator
    2. Navigate to **User Administration** → **Users**
    3. Create or select a dedicated integration user (e.g., `bondata.integration`)
    4. Set a strong password
    5. Assign roles that grant read access to the tables you want to sync (for example `itil` or `rest_service`)
  </Tab>

  <Tab title="OAuth 2.0 (Recommended)">
    1. Navigate to **System OAuth** → **Application Registry**
    2. Click **New** and select **Create an OAuth API endpoint for external clients**
    3. Enter a name (e.g., `BonData Integration`)
    4. Save and copy the generated **Client ID** and **Client Secret**
  </Tab>
</Tabs>

<Note>
  Make sure the integration user or OAuth client has read access to each table. ServiceNow enforces access control lists (ACLs) on every Table API request.
</Note>

### Step 3: Enter Credentials in BonData

1. In BonData, navigate to **Integrations** and select **ServiceNow**
2. Enter your **Instance URL**
3. Enter your **Username** and **Password**, or your **Client ID** and **Client Secret**
4. Click **Connect**

## Required Fields

<Tabs>
  <Tab title="Basic Auth">
    | Field        | Description                  |
    | ------------ | ---------------------------- |
    | Instance URL | Your ServiceNow instance URL |
    | Username     | Integration user name        |
    | Password     | Integration user password    |
  </Tab>

  <Tab title="OAuth 2.0">
    | Field         | Description                                 |
    | ------------- | ------------------------------------------- |
    | Instance URL  | Your ServiceNow instance URL                |
    | Client ID     | Client ID from the Application Registry     |
    | Client Secret | Client Secret from the Application Registry |
  </Tab>
</Tabs>

## Available Data

Once connected, BonData can sync the following ServiceNow tables:

* **Incidents** - Incident records (`incident`)
* **Problems** - Problem records (`problem`)
* **Changes** - Change requests (`change_request`)
* **CMDB Configuration Items** - Configuration items from the CMDB (`cmdb_ci`)
* **Users** - User records (`sys_user`)
* **Groups** - Assignment and user groups (`sys_user_group`)
* **Catalog Items** - Service catalog items (`sc_cat_item`)