How can we help you?

I use Skilleo. How do I enable the integration and add a new stage?

Greenhouse and Skilleo have created an integration so that you can seamlessly use the two products together to add an assessment to your interview pipeline.

To implement the integration, you will:

  1. Contact Skilleo to request your API key.
  2. Fill out the form at or to click here open a ticket. Please do not send the API key in this initial email.
  3. The Greenhouse Support Team will respond with a SendSafely link for you to enter your API key into (How does SendSafely work?), which will notify Greenhouse Support once the API key has been entered.
  4. Greenhouse Support will then email you back confirming that your API key has been setup in your account and your integration is ready to go. 
  5. Add a special Skilleo stage to your interview pipeline.
  6. As candidates enter that stage, send the Skilleo test through Greenhouse.
  7. Once candidates submit test solutions, a link to the report in Skilleo will be accessible through the Interview Kit in Greenhouse.

Enabling the Integration

To enable the integration, copy your API Key from Account setting page on Skilleo. Once you have it, forward it on to your Greenhouse Account Manager. You Account Manager will enter the API Key into the system and then let you know when the integration is ready to go.

Adding the Skilleo Interview Stage

To add the stage to your Interview Plan:

  • Navigate to a specific job, then click the Job Setup tab
  • Click Interview Plan
  • Scroll down the page, and click the green +Add Stage button
  • Select Skilleo, and click the Add button

Configuring the Stage

Once the stage has been added, click Edit Take Home Test. From there, you will see a drop-down menu that reflects the tests that you’ve previously set up in Skilleo. Select the appropriate test, assign at least one Greenhouse user to grade/review submitted tests, and then click Save.

Keep in mind that all configuration of the assessment itself, as well as the email template, will need to be handled in Skilleo. While you will click "Send Test" from within Greenhouse, the interview instructions are actually sent by Skilleo.

Sending the Test

When candidates are moved into the Skilleo Interview stage, Greenhouse will display a Send Test link. While you will click "Send Test" in Greenhouse, the interview instructions will actually be sent through Skilleo.

The status of the assessment will be viewable in Greenhouse:

  • Take Home Test to be sent.
  • Waiting for candidate to submit test
  • Scorecard due from <DESIGNATED_GRADER>

Reviewing Test Results

Once the candidate has submitted their test, the Interview Kit will contain a link to view the submitted test on Skilleo.