Greenhouse integration allows you to assess the skills of your candidates as a part of the Greenhouse workflow. Simply add a DevSkiller stage to your interview pipeline at Greenhouse and invite candidates to perform the test through Greenhouse. The results will appear in Greenhouse, allowing you to complete a scorecard and advance/reject candidates. In this article, we will cover how to:
- Enable Greenhouse/DevSkiller Integration
- Customize User Setup Permissions in Greenhouse Recruiting
- Configure the Job Board inpost open jobs and upload candidates for different customers and departments within the customer’s account.
- Use the Greenhouse/DevSkiller integration
Enable Greenhouse/DevSkiller Integration
To start, contact your DevSkiller representative at (contact info for API key) to receive your API key. Once you have received your API key, email firstname.lastname@example.org or click here to open a ticket.
Note: Do not send the API key in this initial email. API Keys allow access to sensitive data and must be kept secret. If an API Key is shared in an email and your email is intercepted by a malicious third party or your email account is hacked, the hacker would be able to view and access your API Key. For this reason, we require API Keys to be shared securely using SendSafely, Greenhouse’s secure data transfer platform.
The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key. A notification will be sent to the Greenhouse Support Team after you have entered your API key and they will email you to confirm that your API key has been set up in your account and your integration is enabled.
Here’s a quick guide on how to obtain your API key in DevSkiller:
DevSkiller is a platform for companies to test software developers. We provide a tool to evaluate the skills of those developers and aid in the automatization of recruiting processes. This happens with the help of our library of tests and tasks designed to reflect real issues developers might face in their daily work. Companies can also create their own to best suit their needs. While screening technical talent is our specialty we also aim to guide tech HR managers and try to offer the best advice through articles written by our top Development and HR specialists.
Customize User Setup Permissions in Greenhouse Recruiting
In order to enable the Greenhouse/DevSkiller integration, you will need the developer’s permission Can manage ALL organization’s API Credentials.
Contact a Greenhouse user in your organization with Site Admin level permissions with the additional user-specific permission Can edit another user's advanced permissions to apply the API credential management permission to your account. Have the user with Site Admin level permissions edit your user account's permissions by navigating to the Configure icon > Users > Your Name)
The user with Site Admin level permissions should navigate to the Permissions panel on your user page and expand the Developer Permissions dropdown menu.
Select Can manage and configure webhooks so that a check is in the checkbox. When finished, click Save.
Repeat as necessary for any other user that should have access to set up the integration.
Configuring your Job Board
For DevSkiller to pull your open jobs, you will need to send them your job board token. Usually that's pretty simple (e.g. CompanyABC’s board token is "companyabc" with the URL being https://api.greenhouse.io/v1/boards/companyabc/jobs)
To receive the job board token, complete the following steps:
- Click on the “Configure” tab
- Select Job Board
- Click Edit
The job board token will be located in the URL field
How to use the DevSkiller Integration with Greenhouse
After fulfilling all necessary steps of integration creating jobs and candidates on the Greenhouse end, you can start recruiting using Greenhouse!
The first step would be adding a “Devskiller” Stage to your Interview Plan. In order to do this please follow the steps:
1. Click the +Add Stage button in your Interview Plan panel
2. Select DevSkiller from the list, then click the “Add” button
3. Click “Edit” on the new step you’ve added
4. Select the DevSkiller test you want to include in this step, the information will be imported from your DevSkiller Account (Active tests)
5. Customize all options in the section according to your recruiting needs, then click “Save”
You’ve successfully included the DevSkiller Stage in your interview.
You can send invitations to the candidates you want!
To do this, access the candidate/candidates or job opening, go to the DevSkiller Stage and click “Send Test”, select the person from your team to grade it, and click the “Send Test” button in the lower right corner.
Notice: The other options like the recipient and test are set by default but you can change them.
Once the candidate or candidates complete the test and send their answers, you will be notified via email and suitable information will appear in both DevSkiller and Greenhouse. You can then assess them and make a decision based on the score they’ve received from the DevSkiller test.
In Greenhouse, the score will appear in your Interview Kit. It may serve as a summary of the timespan of the recruitment process as shown below:
While in DevSkiller you will have access to the full test results:
After filling your scoreboard, you will be able to decide on the candidate - whether to proceed further with the recruitment process or reject the candidate. It’s important to notice that making a decision in DevSkiller doesn’t affect the decision in Greenhouse. It’s made so you have control over your candidate in Greenhouse, as the complete candidate assessment tool.
Candidates can appear on your list in different phases of the DevSkiller stage of the recruitment, depending on how advanced the process is.
The most important ones that you will encounter are:
1. Waiting for the candidate to submit the test - This means that the candidate you’ve invited either hasn't submitted the answers to the test or they are still being evaluated. You can check this in your DevSkiller account
2. Scoreboard due to [the person responsible for the candidate] - The candidate is waiting for the person responsible to fill the scoreboard
3. Needs decision in DevSkiller - This means the scoreboard has been filled and there is a recommendation from the recruiter on whether you should accept the candidate or not. The DevSkiller score from the test is also displayed along with a thumbs down or thumbs up icon
As shown below, all this information is accessible from your Dashboard in Greenhouse:
After using the integration, you may decide you want to share more info between Greenhouse and DevSkiller. If you would like additional information transferred over, please reach out to DevSkiller Customer Success with a list of items to add!
Please contact email@example.com for troubleshooting assistance regarding the integration.