Universal Background Screening is a nationally accredited screening firm that specializes in employment background checks, drug testing, OccuHealth, verifications, employment physicals, and compliance management services. Companies of all sizes and industries rely on Universal before finalizing their hiring decisions, including retail services, healthcare providers, educational institutions, manufacturers, financial service organizations, and staffing agencies.
Universal Background's integration with Greenhouse Recruiting allows employers to export candidates from Greenhouse Recruiting directly to Universal Background Screening for background screening orders when candidates are marked as hired.
Set up the integration
To set up the integration, you need 2 pieces of information:
- Universal Background's endpoint URL
- Universal Background's secret key
To retrieve this information, contact your account executive at Universal Background Screening. Let them know you'd like to integrate with Greenhouse Recruiting.
Tip: If you're new to Universal Background Screening, reach out to (877) 263-8033
to get started. Universal Background Screening will help set up the integration with Greenhouse Recruiting.
Create a webhook
Once you receive your endpoint URL and secret key from Universal Background, follow the steps in this article to create a webhook in Greenhouse Recruiting. Use the values listed below to configure the webhook:
- Name: Universal Background Screening
- When: This selection is customized for each Universal Background Screening integration. Contact your Universal Background Screening representative for more information.
- Endpoint URL: The Endpoint URL provided by Universal Background Screening
- Secret Key: The Secret Key provided by Universal Background Screening
- Error recipient email: The administrator of your organization's Greenhouse Recruiting account
- Disabled: No
Create a Harvest API key
Next, create a Harvest API key. Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Universal Background integration.
In the Create New Credential box, make the following selections:
- API Type: Harvest
- Partner: Universal Background
- Description: Universal Background Harvest API Key
Verify that the following permissions are selected for the Universal Background integration:
- Activity feed
- Candidates
- Education
Copy your API key to a secure location, then securely share the API key with your Universal Background Screening account executive. They'll finish the integration setup.
Use the integration with Greenhouse Recruiting
Once the integration is enabled, log in to Greenhouse Recruiting and navigate to a candidate who is ready for an offer to be created.
Move the candidate to the offer stage, and create an offer if one hasn't been created already.
Construct the offer details as needed, then save and send the offer to the candidate as necessary.
Tip: Learn more about how to create an offer.
When you click Offer Accepted on the candidate's offer, an order will be immediately sent to Universal Background Screening. Details of the order status will appear on the candidate's Activity Feed in Greenhouse Recruiting, along with a link to the Universal Background Screening portal.
Click the link to log in and review the candidate's information in the portal. Select the package you need for the screening, and finish the order.
When a partial or a completed background report is available, you can find the update on the candidate's Activity Feed in Greenhouse Recruiting. Click the link to view the report directly in Universal Background Screening.
Additional resources
For additional information or troubleshooting not covered here, reach out to your account executive at Universal Background Screening.