Skip to main content

Using the First Advantage (Sterling) Integration

Many of our customers use First Advantage (formerly Sterling) as their background check provider, with our new integration it's now even easier via Pinpoint.

Written by Bill Rogers

Pinpoint's integration with Sterling allows you to order background and other checks on a candidate from within the Pinpoint interface using your company's Sterling account.

The guide to the Sterling integration is split into 3 parts


Roles required to configure and use the Sterling Integration

In order to enable and configure the Sterling integration ahead of it's use, you'll need to have the Company Manager role assigned to you.

To order check on candidate and be able to view the results, you'll need the Background Check Creator role.

If you just need to give people access to view a completed background check result, you can assign them the Background Check Viewer role


Connecting Pinpoint to your Sterling account

Step 1

From the left hand menu, select the Integrations page under the settings menu.

Step 2

In the integrations menu, click on the Apps button and then search for, or scroll down to, the Sterling integration. Click the Add button for that integration.

Step 3

With the integration added, you'll need to fill in your Client ID and Client Secret, and select which the region you're operating in. You can get these details from Sterling's team if you don't already have them.

Step 4:

Once you have successfully saved your Hirer ID, you'll need to make sure the toggle switch in the top right hand corner of the page is set to Enabled, and with this done, it will now be possible to post jobs


Customising how statuses appear in Pinpoint

When First Advantage (Sterling) tells Pinpoint that something has happened to a background check, Pinpoint translates their status into the closest matching Pinpoint background check status. That happens automatically and most customers never need to change it.

If those default statuses don't reflect the way your team works, you can override them. There are two optional settings at the bottom of the integration's settings page, and both are off until you turn them on:

  • Custom status mapping - decide which Pinpoint status a First Advantage status or result becomes.

  • Custom sub-status mapping - use First Advantage's sub-status to decide the Pinpoint status.

You only need to list the values you want to change. Anything you don't list carries on behaving exactly as it does today.

When is this worth doing?

  • To see invite problems. First Advantage reports outcomes like Invite Incomplete and Cancelled Invite as sub-statuses. Mapping them means a recruiter can see at a glance that a candidate never completed their invitation, instead of assuming the check is still in progress - and won't order a duplicate check.

  • To match your own process. If your team thinks about a stage differently to Pinpoint's default wording, map it to the status you'd rather see.

  • To ignore updates you don't care about or hiring managers shouldn’t see. You can tell Pinpoint to leave a check alone when a particular status update comes in.

Setting up custom status mapping

Go to Company → Settings → Integrations, open First Advantage (Sterling), and switch Custom status mapping on. Then click Add status mapping and complete a row for each value you want to change:

  • First Advantage (Sterling) status/result - type the value exactly as First Advantage sends it, including capitalisation. There's no dropdown here, because the list depends on your own First Advantage set-up. Clear and clear are not the same value, and a value that doesn't match exactly is simply never used.

  • Pinpoint status - choose the status you want to see in Pinpoint, or choose Ignore.

Add as many rows as you need, then click Save. Use Remove to delete a row.

Not sure of the exact wording First Advantage uses? Your First Advantage account manager can confirm it, and it's also the value you'll see coming through on your existing checks. You can also see the list in the Sterling documentation.

Setting up custom sub-status mapping

Switch Custom sub-status mapping on and click Add sub-status mapping. It works the same way, except the value on the left is First Advantage's subStatus, and it behaves with a higher priority:

  • A mapped sub-status wins. If a check arrives with a sub-status you've mapped, that becomes the status shown in Pinpoint, even if the main status or result says something else.

  • Anything you haven't mapped is ignored, and Pinpoint falls back to the main status or result as usual.

While custom sub-status mapping is on, Pinpoint is using the sub-status to decide the main status, so it no longer records it separately as a sub-status on the check.

⚠️To map substatuses, please ask First Advantage to enable sub-statuses for the API integration on your account (as it’s not enabled by default).

What "Ignore" does

Ignore means "don't act on this":

  • On custom status mapping, Pinpoint leaves the background check exactly as it is when that value comes in - the status doesn't change.

  • On custom sub-status mapping, Pinpoint disregards that sub-status and uses the main status or result instead.

If a value isn't in your list

Nothing breaks. Pinpoint falls back to its built-in mapping, so any value you haven't listed behaves exactly as it did before you turned the setting on. You can find the built-in mapping in Default status mapping at the end of this article.

Where a check has a completed report, the First Advantage result takes priority over its main status.


How do I check a candidate using Pinpoint's Sterling integration?

Step 1

While looking at the candidate's application profile, click the action button (the three small dots) above their details, select the Sterling Background Check option:

Step 2

The Background Check form will open. The details that we hold on the candidate will populate the Name and Email Address fields, but you'll need to select the correct Package and Bill Code. The items available to pick from in these lists are supplied to us by Sterling and depend on your which of their services you have set up, so you can add additional packages via Sterling's team if you need additional options. When you've selected everything correctly, hit the Send Invite button.

Once you've pressed Send Invite, the candidate will receive an invite to start the process.

Step 3

With the invite sent, you can monitor the status of the background check within Pinpoint via the Background Checks tab on a candidate's application. Invited candidates will have the Invited Status, Candidates that have started the process or who are being reviewed by Sterling will be Pending, and when the results are ready, the candidate will be marked as Complete. Once they have been marked as completed, you can click the click the View Report button to view the complete set of results from within the Sterling interface.

These are the default statuses. If you'd rather Pinpoint showed different ones, see Customising how statuses appear in Pinpoint above.

Step 4

You will be notified if a candidate you have visibility over's background check has been completed and the results are ready for you to view, as long as you have the 'New Background Check Report Received' notification enabled. It will be enabled for you by default, but you can enable or disable it from your personal settings menu, found by clicking your initials in the top right hand corner, selecting the Settings menu and then, the notifications tab.


Appendix: default status mapping

This is what Pinpoint does out of the box, with no custom mapping turned on. Where a check has a completed report, the result table takes priority over the status table.

First Advantage status → Pinpoint status

First Advantage status

Pinpoint status

PreDraft

Draft

Draft

Draft

NotStarted

Invited

InProgress

In progress

Pending

Pending

Clear

Clear

Consider

Consider

Complete

Completed

ActionNeeded

Action required

ReadyForReview

Ready for review

Review

Review

AdverseAction

Adverse action

Pre-Adverse Action Initiated

Pre adverse action

Pre-Adverse Action Sent

Pre adverse action

Adverse Action Paused

Adverse action

Adverse Action Cancelled

Adverse action

Adverse Action Resumed

Adverse action

Adverse Action Sent

Adverse action

Dispute

In dispute

Archive

Archive

Hold

Hold

Pending Adjudication

Pending adjudication

Expired Invite

Expired

Deleted

Deleted

Passed

Passed

First Advantage result → Pinpoint status (completed reports)

First Advantage result

Pinpoint status

Pending

Pending

Clear

Clear

Consider

Consider

Pass

Passed

Passed

Passed

Review

Review

Cancelled

Canceled

Complete

Completed

AMBER

Consider

RED

Adverse action

GREEN

Passed

Sub-statuses

There is no built-in mapping for First Advantage sub-statuses. If you want values such as Invite Incomplete or Cancelled Invite to determine the status shown in Pinpoint, you need to turn on custom sub-status mapping and map them yourself.


FAQ

Q: Are the First Advantage values for the mapping case-sensitive?

A: Yes. The value you type has to match exactly what First Advantage sends, capitalisation included - Clear and clear are different.

Q: What happens if a value comes in that I haven't mapped?

A: Pinpoint uses its default mapping for it. For sub-statuses, it falls back to the main status or result.

Did this answer your question?