---
title: "ServiceNow HAM"
slug: "servicenow-ham"
updated: 2025-12-10T15:44:48Z
published: 2025-12-10T15:44:48Z
canonical: "docs.databee.buzz/servicenow-ham"
---

> ## 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 HAM

**ServiceNow Hardware Asset Management** application supplements the capabilities of the Hardware Asset Management (HAM) Professional plugin. It enables lifecycle reporting and dashboard analytics by providing the scheduled job **HAM – Generate Data for Hardware Lifecycle Report**. For detailed information refer to [ServiceNow’s official documentation](https://store.servicenow.com/store/app/fde8e72e1be06a50a85b16db234bcb67).

**Integration Method:** API

**Tables**: Device Inventory Info [5001]

This integration supports the following events.

| **Event** | **Description** |
| --- | --- |
| Hardware Product Models | Retrieves data for all the hardware products models |

This integration supports the following versions.

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

## Prerequisites

- ServiceNow **Admin** privileges to create an OAuth API endpoint for external clients.
- 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](/user-manual/docs/servicenow-ham#create-oauth-client-application)
  2. [Create user](/user-manual/docs/servicenow-ham#create-user)
  3. [Assign roles to user](/user-manual/docs/servicenow-ham#assign-roles-to-user)
2. Add the [ServiceNow HAM Data Feed](/user-manual/docs/servicenow-ham#databee-configuration) integration in the DataBee console with the required API credentials.

| **DataBee Parameter** | **ServiceNow Parameter** |
| --- | --- |
| Client Key | Client ID |
| Client Secret | Client Secret |
| Username | User ID |
| Password | Password |
| Token URL:<instance> | ServiceNow Instance |
| API URL :<instance> | ServiceNow Instance |

## ServiceNow Configuration

The scope is a mechanism to limit application access to ServiceNow 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-ham-image-7sreh0d2.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
2. Navigate to **All**.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-cd5ppjrg.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  1. In the search bar, enter **System OAuth**.
  2. Navigate to **System OAuth** > **Application Registry**.
3. Click on the **New** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-r06av4j8.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
4. Click the **Create an OAuth API endpoint for external clients**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-f5sb0v5q.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
5. Fill in the required details in the form:

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

Click on the **Submit** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-bg2coba5.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  1. **Name**: Enter a unique name for OAuth client application.
  2. **Client ID**: Automatically generated by the ServiceNow OAuth server.
  3. **Client Secret**: Enter Client secret for the Oauth application or leave empty for auto generation
6. Select the Application created in the previous step from the Application Registries table. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-12eubu1x.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
7. Click on the **Lock** icon and save the **Client Secret** for later use. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-p6ldhzab.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)

Verify the following fields and values before proceeding.

| **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**,

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-7abidk61.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  1. In the search bar, enter **User Administration**.
  2. Navigate to **User Administration** > **Users**.
2. Click on the **New** button. The **Create User** form window will appear. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-hfh035qf.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
3. Fill in the required fields to create a user:

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

> [!NOTE]
> **Note:**
> 
> Copy the **User ID** for later use.

Click the **Submit** button.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-9xfjazv6.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  - **User ID**: Enter a unique username.
  - **First Name**: Enter the user's first name.
  - **Last Name**: Enter the user's last name.
  - **Time Zone**: Set to **GMT/UTC** to ensure the API response includes GMT/UTC dates.
  - **Date Format**: Set to **System (yyyy-MM-dd)**.
  - **Active**: Ensure the checkbox is selected.
  - **Locked Out**: Ensure the checkbox is **not** selected.
4. Search 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-ham-image-iq8cg85g.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
5. Click on the **Set Password** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-a7g8gux7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
6. Click on the **Generate** button and copy the **password** for later use.

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-0x5p98s7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)

After saving password, if *Password needs reset* checkbox is checked, uncheck it.
  1. Click on the **Save Password** button.
  2. Click on the **Close** button.

### Assign roles to user

1. Go to the **Roles** tab and click on **Edit** to assign roles to the user. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-76o2z548.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
2. In the search bar:

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-mz39s2av.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  1. Enter **sn_hamp.ham_user** and select it.
  2. Click on **Add icon** button.
  3. Click the **Save** button.

## DataBee Configuration

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-ham-image-qcheuqsi.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
2. Search for **ServiceNow HAM** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-bitajcod.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
3. Click on the **API Ingest** option for the collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-9lkjusfz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
4. Enter feed contact information. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-dad4hezj.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
5. In the configuration, confirm the following:

![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-ham-image-ngh5938h.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A22%3A05Z&se=2026-10-30T13%3A22%3A05Z&sr=c&sp=r&sig=5HWPESsDGngTQFzK5x%2BFEVVWenHsbMuG%2BJ30vixVEeo%3D)
  1. **Authorization Method**: OAuth2
  2. **API Base URL**: Replace **<instance>** with your ServiceNow Instance.
  3. **Username:** Paste the User ID.
  4. **Password**: Paste the Password .
  5. **Client Key:** Paste the Client ID generated earlier in the ServiceNow Platform.
  6. **Client Secret**: Paste the Client Secret generated earlier in the ServiceNow Platform.
  7. **Token URL**: Replace **<instance>** with your ServiceNow Instance.
  8. **Event Types**: Preselected for all the event types that integration pulls.
6. Click **Test Connection** and click **Submit**.

## 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.

#