Skip to content
English
Go to veremark.com
  • There are no suggestions because the search field is empty.

Service Now Integration

Setting Up the Veremark Integration for ServiceNow

The Veremark for ServiceNow integration lets your HR team initiate background check requests and track their progress directly within ServiceNow, without switching between platforms. This guide walks you through installing the app, connecting your Veremark account, and running your first request.

Before you begin

Make sure you have the following in place before starting the setup:

    • An active Veremark account, sign up or log in at veremark.com

    • A valid Veremark API access token (contact your Veremark account manager if you don't have one)

    • A ServiceNow user account with the admin role

Step 1 - Install the Veremark Checks app

1. Find the app in the ServiceNow App Manager

    • In your ServiceNow instance, navigate to App Manager from the main menu.

    • Search for "Veremark Checks" and select it from the results.


2. Install the app

    • Click Install and follow the on-screen prompts to complete the installation. Once installed, the Veremark Checks app will be available in your ServiceNow instance.

Step 2 - Configure your Veremark API token

Once the app is installed, you need to connect it to your Veremark account using your API token.

1. Open Connection & Credential Aliases

    • From the ServiceNow main menu, navigate to Connection & Credential Aliases.

2. Select the Veremark API Connection Alias

    • Click on Veremark API Connection Alias from the list.

    • In the Connections tab, select Veremark API Connection.

3. Enter your API token

    • Under API Key Credentials, select Veremark API Key.

    • Replace the value in the API Key field with the token provided by Veremark.

    • Click Update to save your changes.



Step 3 — Sync your Veremark Criteria

Veremark Criteria are the background check packages available to your organisation. When you first install the app, this list will be empty, you need to run an initial sync to populate it.

1. Navigate to the Veremark Criteria table

    • From the ServiceNow main menu, search for and navigate to Veremark Criteria.

2. Run the Criteria sync

    • Click the Veremark Criteria Sync button in the top-right corner of the table.

    • Wait approximately 30 seconds, then refresh the page. Your organisation's Veremark Criteria will now appear in the table.

After the initial sync, your criteria will stay up to date automatically, the integration syncs with Veremark once per day. You can also trigger a manual sync at any time by clicking Veremark Criteria Sync again.

 
 

Step 4 - Create a background check request

 Once your criteria are synced, you can start submitting background check requests for candidates directly from ServiceNow.

 

1. Open the Veremark Requests table

    • From the ServiceNow main menu, search for Veremark Requests and select it from the results.

2. Add a Request

    • Click New to create a new record. Fill in the candidate's details:

      • Criteria guid — select the appropriate background check package from your synced Veremark Criteria

      • First name and Last name

      • Email — the candidate's email address

      • Job role

      • Once complete, click Submit.


3. Confirm the request was created

    • After a few seconds, refresh the Veremark Requests table. You should see:

      • The record's Status has changed to Requested

      • A unique Request URL has been populated — this links directly to the request in your Veremark account

      • The request will also be visible in your Veremark account under Requests.



Step 5 - Track request status

Once a request has been submitted, its status will update automatically in ServiceNow as the background check progresses - no manual checking required.

Status updates are sent from Veremark to your ServiceNow instance via a webhook. Each time Veremark processes an update for a candidate, the corresponding record in the Veremark Requests table will reflect the latest status automatically.

To view the current status of any request, navigate to Veremark Requests from the main ServiceNow menu and find the relevant record.


You can also access the full request detail at any time by clicking the Request URL in the record - this will open the request directly in your Veremark account.