--- title: "ServiceNow Users" slug: "servicenow-users" updated: 2026-04-24T14:55:46Z published: 2026-04-24T14:55:46Z canonical: "docs.databee.buzz/servicenow-users" --- > ## 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 Users ServiceNow user records establish a relationship between an individual and your ServiceNow instance. User records consist of a user name, a password, and information relating to the individual, such as contact information, location, and job title. For detailed information refer to the [ServiceNow’s official documentation](https://www.servicenow.com/docs/bundle/yokohama-platform-administration/page/administer/roles/concept/user.html). **Integration Method:** API **Tables**: User Inventory (5003) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Users | Retrieves data for all User details | 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-users#create-oauth-client-application) 2. [Create user](/user-manual/docs/servicenow-users#create-user) 3. [Assign roles to user](/user-manual/docs/servicenow-users#assign-roles-to-user) 2. Add the [ServiceNow Users Data Feed](/user-manual/docs/servicenow-users#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: | ServiceNow Instance | | API URL : | 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-users-image-mmc11mg1.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 2. Navigate to **All** 1. In the search bar, enter **System OAuth**. 2. Navigate to **System OAuth** > **Application Registry**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-4on2x9eq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 3. Click on the **New** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-qs1yjxcz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 4. Click the **New Inbound Integration Experience**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-h1tewss7.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 5. Click the **New Integration** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-wvcrarkz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 6. Click the **OAuth – Resource owner password credential grant**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-mmv302hz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 7. Fill in the required details in the form: 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. 8. Copy the **Client ID** for later use. 9. Click on the **Save** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-mh3hrzig.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 10. Click **Skip for now** in the dialogue box. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-d090usaj.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 11. 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-users-image-8c3wtsur.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 12. Click on **Lock** icon and save the **Client Secret** for later use. Also make sure the **Scope Restriction** is set to **Broadly scoped**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-igde2nrl.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%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-users-image-0yc8pmhq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 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-users-image-0h592q8y.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%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. - **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. Copy the **User ID** for later use. 5. Click the **Submit** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-q6udc4mz.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 6. 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-users-image-y2j86q58.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 7. Click on the **Set Password** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-diqfwcga.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 8. Click on the **Generate** button and copy the **password** for later use. 1. Click on the **Save Password** button. 2. Click on the **Close** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-jqk4c26f.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%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-users-image-1iqdxmv0.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 2. In the search bar: 1. Enter **"user_admin"** or **"itil"** and click **Add**. > [!NOTE] > **Note:** > > The created user must be an **allowed member** to fetch a user record when the **user_admin** role is assigned. Additionally, if you select the **itil** role while adding a role, the following fields will be missing in the API response. | **Event Type** | **Missing Fields** | | --- | --- | | Users | locked_out, password_needs_reset | 3. Click the **Save** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-izqdfghq.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) ## 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-users-image-8jotlwt8.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 2. Search for **ServiceNow Users** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-by22qke0.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 3. Click on the **API Ingest** option for collection method. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-gvneye04.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 4. Enter feed contact information and scroll down. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-7kwcqzmm.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 5. In the configuration page, confirm the following: - **Authorization Method**: OAuth2 - **API Base URL**: Replace **** with your ServiceNow Instance. - **Username:** Paste the User ID. - **Password**: Paste the Password . - **Client Key:** Paste the Client ID generated earlier in the ServiceNow Platform. - **Client Secret**: Paste the Client Secret generated earlier in the ServiceNow Platform. - **Token URL**: Replace **** with your ServiceNow Instance. - **Event Types**: Preselected for all the event types that integration pulls. - **Include Inactive Users**: Select checkbox if you want to include the inactive ServiceNow users along with the ServiceNow active users. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/servicenow-users-image-04nvmvoa.png?sv=2026-02-06&spr=https&st=2026-10-30T12%3A21%3A11Z&se=2026-10-30T13%3A21%3A11Z&sr=c&sp=r&sig=GD5DCmC%2BFyK2UQDFOeoOBfIxqiM8oxiZUIMyAxqbuVI%3D) 6. 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.