---
title: "Servicenow CMDB"
slug: "servicenow-cmdb"
updated: 2026-01-15T18:07:21Z
published: 2026-01-15T18:07:21Z
canonical: "docs.databee.buzz/servicenow-cmdb"
---

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

# Servicenow CMDB

ServiceNow Configuration Management Database (CMDB) is a centralized repository that serves as a comprehensive data warehouse, organizing information about an IT environment. The CMDB clarifies the relationships between hardware, software components, and networks, enhancing configuration management. More information can be found at [ServiceNow CMDB webpage.](https://www.servicenow.com/products/servicenow-platform/configuration-management-database.html#benefits)

**Integration Method:** API

**Tables**: Device Inventory Info (5001), Software Inventory Info (5020)

List of events supported by this integration.

| **Events** | Retrieves data for all the groups with respective user details |
| --- | --- |
| CMDB CIs | Retrieves data for all the groups with respective user details |
| User Groups | Retrieves data for all the groups with respective user details |

This integration supports the following versions

| ServiceNow Version Tested | ServiceNow version Vancouver |
| --- | --- |
| ServiceNow API version | v2.0 |

# Prerequisites

1. Access to the ServiceNow CMDB **Admin** Role to create an OAuth API endpoint for external clients.
2. Access to the DataBee console.

# Configuration Overview

1. Generate API credentials on the ServiceNow console with the required user roles.
  1. [Create OAuth client application](/docs/servicenow-cmdb#Bookmark1)
  2. [Create user](/docs/servicenow-cmdb#create_user)
  3. [Assign roles to user](/docs/servicenow-cmdb#Bookmark2)
2. Add the [ServiceNow data feed](/docs/servicenow-cmdb#databee_configuration) integration in the DataBee console with the required API credentials.

| **DataBee Feed Parameter** | **ServiceNow Parameter** |
| --- | --- |
| Client Key | [Client ID](/docs/servicenow-cmdb#client_creds) |
| Client Secret | [Client Secret](/docs/servicenow-cmdb#client_creds) |
| Username | [User ID](/docs/servicenow-cmdb#username) |
| Password | [Password](/docs/servicenow-cmdb#password) |
| TOKEN URL :<instance> | [ServiceNow Instance](/docs/servicenow-cmdb#Instance) |
| API URL :<instance> | [ServiceNow Instance](/docs/servicenow-cmdb#Instance) |

# ServiceNow Configuration

The scope is a mechanism to let an application request limited access to a user’s data. ServiceNow platform supports authentication scopes to allow admins to limit access of an OAuth client application to a specific REST API.

## Create OAuth client application

1. Get the servicenow instance from the URL as highlighted below.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-0xwvuib7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Navigate to **All**
  - In the search bar, enter **System OAuth.**
  - Navigate to **System OAuth > Application Registry**.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-6157t6m3.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **New** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-5cks5o00.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. On the Interceptor page, click **Create an OAuth API endpoint for external clients.**

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-tn0yseom.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Fill in the required details in the form:
  - **Name**: Enter a unique name for OAuth client application.
  - **Client ID**: Automatically generated by the ServiceNow OAuth server.
  - **Client Secret**: Enter Client secret for the Oauth application or leave empty for auto generation

Copy the **Client ID** and **Client Secret** for later use.

1. Click on the **Submit** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-k39g7tez.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Select the Application Registries from the previous step

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image(433).png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)
2. Click on the **Lock** icon and save the Client Secret for later use

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/image(434).png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

| Name | Unique Name that identifies the application |
| --- | --- |
| Client ID | This will be auto generated by the instance: To be provided to DataBee. |
| Client Secret | This will be auto generated by the instance Or Can Entered: To be provided to DataBee. |
| Refresh Token Lifespan | 8,640,000 seconds (100 days) & can be increased |
| Access Token Lifespan | 1800 seconds (30 Minutes) & can be increased |

## Create User

1. Navigate to **All**,
  1. In the search bar, enter **User Administration.**
  2. Navigate to **User Administration** > **Users**.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-f5rc94ay.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **New** button. The **Create User** form window will appear.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-tr959d07.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Fill in the required fields to create a user:
  1. **User ID**: Enter a unique username.
  2. **First Name**: Enter the user's first name.
  3. **Last Name**: Enter the user's last name.
  4. **Time Zone**: Set to **GMT/UTC** to ensure the API response includes GMT/UTC dates.
  5. **Date Format**: Set to **System (yyyy-MM-dd)**.
  6. **Active**: Ensure the checkbox is selected.
  7. **Locked Out**: Ensure the checkbox is **not** selected.

The user must be active and not locked out to allow the instance to generate an access token for OAuth.

Copy the **User ID** and **Password** for later use.

Click the **Submit** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-uqvkml0e.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Search username for the “**User ID**” created in the previous step and click on it.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-g372ps4e.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **Set Password** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-6rcxykdl.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **Generate** button and copy the password for later use.

1. Click on the **Save Password** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-nsrt5vjz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

## Assign roles to user

1. Go to **Roles** tab and click on **Edit** to assign roles to user. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-0732q8cy.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)
2. In the search bar:
  1. Enter **"ITIL"** and click **Add**.
  2. Click the **Save** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-x8vottvn.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

# DataBee Configuration

Use the saved client secret and key to configure DataBee. Detailed setup documentation can be found at [https://docs.databee.buzz/docs/api-ingest](https://docs.databee.buzz/docs/api-ingest)

1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-xyhuq9xx.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Search for **Servicenow CMDB** and select it.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-x20x2ryn.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **API Ingest** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-ixv3a8xv.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Enter basic contact information in the contact form and click on the **Next** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-cmdb---feb-2025-image-7qvxjco6.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. In the configuration page, enter the following:
  - **API Base URL**: Replace **<instance>** with your [ServiceNow Instance](/docs/servicenow-cmdb#Bookmark1).
  - **Authorization Method**: OAuth2
  - **Username:** Paste the [User ID](/docs/servicenow-cmdb#Bookmark3).
  - **Password:** Paste the [Password](/docs/servicenow-cmdb#Bookmark4) .
  - **Client Key:** Paste the [Client ID](/docs/servicenow-cmdb#Bookmark2) generated earlier in the ServiceNow Platform.
  - **Client Secret**: Paste the [Client Secret](/docs/servicenow-cmdb#Bookmark3) generated earlier in the ServiceNow Platform.
  - **Token URL**: Replace **<instance>** with your [ServiceNow Instance](/docs/servicenow-cmdb#Bookmark1).
  - **Event Types**: Preselected for all the event types that integration pulls
  - **Filter**: Select whether to **include** or **exclude** specific CMDB tables. The **None** filter option will fetch all classes.
  - **CMDB Tables:** Select the tables to include or exclude as part of the Filter option. Leave it blank to select all tables

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ServiceNowFilter.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A18Z&se=2026-10-30T13%3A21%3A18Z&sr=c&sp=r&sig=W%2FG7ZW63EmLZAnNeI9YSbeHFdWFZx0lSfW9%2Bck0CErs%3D)

1. Click on the **Submit** button.

# Troubleshooting Tips

- Ensure the client key, client secret, instance, username and password are pasted correctly. Since you cannot view the client key and secret after the 1st time, re-create the creds, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed
- Make sure the required user role is assigned.

#