The BAL (Berry Appleman & Leiden) integration enables recruiters to request an immigration assessment from Greenhouse Recruiting.
Set up the BAL integration
Contact BAL to receive your API key and click here to open a ticket with the Greenhouse Technical Support team. The Greenhouse Technical Support team will respond with a SendSafety link and you can enter your API key. The Technical Support team will activate the BAL Immigration Assessment stage for your organization.
Create a Harvest API key
Review this article to create the BAL Harvest API key with the following settings:
Credentials
- API type: Harvest
- Partner: BAL or Unlisted Vendor
- Description: BAL Harvest API key
Permissions
-
Applications
- GET: Retrieve Application
-
Candidates
- GET: Retrieve Candidate
-
Job Posts
- GET: Retrieve Job Post for Job
- GET: List Job Posts for Job
-
Jobs
- GET: Retrieve Job
Use the BAL Integration
Now that your integration is set up, you can send tests to your candidates who require immigration sponsorship.
Send the immigration assessment to a candidate
You can send the assessment to a candidate by moving the candidate to the BAL Immigration Assessment stage.
Then, click on the Send Test button.
Note: When you send a test in Greenhouse Recruiting, the BAL integration will connect to the Harvest API to retrieve additional details about the candidate and offered position and initiate the assessment request in BAL’s Cobalt® application. Cobalt® then sends the instructions to the candidate.
After it has been sent, an assessment’s status will display as Pending in Greenhouse Recruiting.
Once BAL has completed the assessment, the task status will be updated in Greenhouse. The results of the assessment will be sent via email.
Additional resources
For additional information not covered here, reach out to techps@balglobal.com.