HireRight integration: Adding a HireRight account in Enterprise via self-service

Prerequisites

Before you set up a HireRight account in Beeline Enterprise, make sure you obtain the following authentication credentials for the client’s or supplier’s HireRight account. HireRight will provide this information to the client or the program office.

• Provider’s API URL/Provider’s Base Location URL; the same URL is used for all suppliers.
• Organization name; the client's HireRight username.
• Client’s or supplier’s company login; a unique value is used to authorize a client’s access to HireRight and to associate suppliers with a Client organization.

You need this information to permit data exchange between the Enterprise platform and HireRight using Beeline’s application programming interface (API) calls.

Persona

Program office users

As a program office user with the appropriate permissions, you must configure HireRight account information in Enterprise for each supplier in your organization. You can configure or import HireRight account details. For instructions on importing, go to Importing integration data.

Setting up HireRight accounts in Enterprise lets you:

• Ensure background checks are processed promptly.
• Link a Supplier’s account to a specific Client.
• Associate a Supplier’s account with specific industries.
• Streamline your onboarding process.

If you’re setting up a client-initiated model, you use the same client HireRight credentials for each supplier HireRight account you add to Enterprise. If you’re setting up a supplier-initiated model, you use separate credentials for each supplier account you add to Enterprise. You can set up and manage supplier account credentials only for organizations and industries you have access to.

1. Select Preferences > VMS Settings > Contingent Staffing. A Contingent Staffing page displays.
2. Select Background Check Provider Settings. A Background Check Provider page displays showing any background check providers already configured in your Enterprise platform.
3. Select Add New. An Add Background Check Provider Settings page displays. Use the fields in the Add Background Check Provider Settings section at the top of the page to associate a client with a provider.
4. In the Name field in the Add Background Check Provider Settings section, enter a label for the provider’s account.
   Best Practice recommendation. Use the provider name followed by a hyphen followed by the supplier name. For example, HireRight‑TopNotchSupplier.
5. Optional:) In the Description field, add an explanation about the provider’s account. For example, your organization might use this field to identify which location or industry uses a specific integration.
6. In the Code field, add an acronym for the provider. You can enter up to 255 characters and camelCase is supported. This code is used to identify background check packages when data is imported.
   Best Practice recommendation. Use the provider name followed by the supplier name. For example, HireRightTopNotchSupplier.
7. Select the Is Active checkbox in the Add Background Check Provider Settings section to make the account available in Enterprise.
8. From the Background Check Provider list in the Provider Settings section, select HireRight as the background check provider you want to associate with the account.
9. In the Provider Base Location URL field in the Provider Settings section, add the HireRight application programming interface (API) URL. This URL allows API exchanges between Enterprise and HireRight.
10. In the Supplier Organization field in the Account Setup section, enter the name of the supplier organization.
11. Follow one of these options:
    • If you’re setting up a client-initiated model, enter the client’s identifier supplied by HireRight in the Company Login field in the Account Setup section.
      OR
    • If you’re setting up a supplier-initiated model, enter the supplier’s identifier supplied by HireRight in the Company Login field in the Account Setup section.
12. From the Available Industries list in the Associated Industries section, select the industries configured for the supplier you want to include in the HireRight integration. Use the Arrow icons to move the industries from Available to Selected.
13. Select OK. A message displays indicating your changes were saved, and the HireRight background check account is activated in Enterprise.
14. Repeat steps 3 through 12 for each HireRight supplier account you need to add.

You’re done setting up HireRight accounts in Enterprise. The HireRight background check provider integration is automatically synchronized with Enterprise after 24‑hours.