Greenhouse and Lytmus ​have created an integration so that you can seamlessly use the two products together to add a Lytmus Take-Home Exam to your interview pipeline.


Enable Greenhouse/Lytmus Integration

To start, log into your Lytmus ​account and copy your API key from the account page here: Once you have received your API key, fill out the form at or click here to open a ticket. 

Note: Do not send the API key in this initial email.

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.

Note: To verify your identity, the Greenhouse Support Team might request you provide a Support Verification Code before adding the API key to your organization's account.



Adding the Lytmus Interview Stage

To add the Interview Stage to your Interview Plan, please do the following:

  1. Navigate to a specific job, and click the Job Setup ​tab
  2. Click Interview Plan
  3. Scroll down the page, and click the green + Add Stage ​button
  4. Select Lytmus​, and then click the Add​ button


Configuring the Stage

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

Please note that all configuration of the Exam itself, as well as the email template, will need to be handled in Lytmus.


Sending the Test

When candidates are moved into the Lytmus ​Interview stage, Greenhouse will display a Send Test ​link. Please note that while you will click Send Test​ in Greenhouse, the interview instructions will actually be sent through Lytmus.

The status of the assessment will be viewable in Greenhouse. Greenhouse-generated status examples are as follows:

  1. Take-Home Exam to be sent
  2. Waiting for candidate to submit Take-Home Exam
  3. Scorecard due from <DESIGNATED_GRADER>


Reviewing Exam Results

Once the candidate has submitted their Take-Home Exam, the Interview Kit will contain a link to view the submitted Exam on Lytmus.