Enabling and using the EMP Trust integration

Setting up the EMP Trust integration

For a more comprehensive guide to enabling and using the integration, please reach out to EMP Trust.

Integration Procedures

Initial Integration Procedures

• You will share your Lever API key with EMP Trust via a Secure email/encrypted mail service.
• These are used as part of the Basic Authentication method to access and invoke all the required API calls.
• EMP Trust service/API will make use of the provided API key to authenticate entry into the Lever system and start the data sync.
• Once the authentication is successful, the service can initiate the data sync procedures by invoking the required APIs.

How does the data sync work?

• A Basic Authentication method is used here before the service is invoked and data sync occurs between the EMP Trust & Lever systems.
• Lever must be set up and configured as a partner in EMP Trust.
• Apart from the API key, the client will have to provide EMP Trust with the stage_id and the date on which the data sync is supposed to start.
• If all the required data has been received, the scheduled service will initiate the data sync accordingly.
• The service will sync data once every 4 hours on a daily basis from Lever systems.
• If the authentication fails, the service will log and send the corresponding message.

Generate the Lever API Key

You will be asked to generate a Lever API Key to share with EMP Trust. Please work with EMP Trust to confirm which API permissions to include. The set of permissions will include the following (at a minimum): 

• list opportunities 
• list opportunity offers
• read user
• list opportunity files
• list opportunity resumes

For additional guidance on generating a Lever API Key please refer to the article Generating and using API credentials.

Configuring the EMP Trust integration

Configure the Webhook

Please work with EMP Trust for additional guidance on configuring the Candidate Hired webhook in Lever. A brief overview of the webhook configuration is provided below:

• Lever can send EMP Trust the data of their new hires at the point of hiring by making use of a webhook.
• The endpoint for the same is authenticated, and it is as follows: https://www.empforce.com/WebApi/lever/{customerCode}
• The endpoint and stage_id must be provided and configured in Lever system.
• All the details that are received from Lever through the webhook are logged first.

When the scheduled service runs, it will sync the Opportunity and Offer information of the candidate.

Using the EMP Trust integration

Data Mapping

Viewing the synced data from Lever in EMP Trust

View New Hires for Onboarding

The details of the new hires can be viewed and re-invited from the View New Hires for Onboarding page in EMP Trust. 

The steps to do the same are as follows:

• Click on the View New Hires for Onboarding menu that comes under the Onboarding Menu.

• Select the appropriate Uploaded period and click Search

• In the grid that displays, all the records invited from the given syncing period will be visible.
• Click on Select against the corresponding new hire.

• This would take you back to the Quick-Invite page. The details of the employee will be auto populated in the respective fields.
• Click Invite to send the invitation.

Quick-Invite Page

The details of the new hires can be viewed and re-invited from the Quick-Invite page in EMP Trust.

The steps to do the same are as follows:

• Click on Quick-Invite in the onboarding main menu

• On the page, enter the name of the new hire from the dropdown or click on the magnifying glass to search for the employee

• Once the new hire is selected, the details of the employee will be auto populated in the respective fields.
• Click Invite to send the invitation again.

Document Center

This integration offers links to download resumes & cover letters of those employee records that have been synced from Lever.

• In the document center of the corresponding employee, a list of available Lever API document links will be displayed. 
• Click the link to download the required document into the user’s system.

Frequently Asked Questions (FAQ)

Does EMP Trust support Form I-9?

Yes, EMP Trust supports I-9 integration. EMP Trust can control which integration points are being set as part of the account configuration. Customers can enable the API Key in the system administration settings for their EMP Trust account. 

Does EMP Trust support E-Verify?

Yes, EMP Trust supports E-Verify integration. EMP Trust can control which integration points are being set as part of the account configuration. Customers can enable the API Key in the system administration settings for their EMP Trust account. 

Disabling the EMP Trust integration

1. In Lever navigate to Settings > Integrations and API
2. Under the API Credentials tab, locate the EMP Trust API credentials
3. Click the trash can icon to disable the integration