SimpleCitizen is a digital immigration and visa solution designed to streamline the pathway to citizenship. As the only truly comprehensive solution, its straightforward process takes applicants from signup to completion, while saving them time and money along the way. They offer an online questionnaire that allows companies to screen hiring candidates based on their immigration eligibility.

Greenhouse Recruiting's integration with SimpleCitizen allows your organization to seamlessly add SimpleCitizen’s immigration screening assessment to a job's interview plan. In this article, we will cover how to:


Enable the Greenhouse/SimpleCitizen Integration

To start, find your company’s API key within SimpleCitizen by navigating to My Companies > [Company] to view your company details.

Click the Integrations tab and click the Add button on the Greenhouse tile.

In the integration modal, click Generate API Token to generate and see your API key.

Once you have retrieved 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.


Add SimpleCitizen Stage to Job’s Interview Plan

Once the Greenhouse/SimpleCitizen integration is enabled for your organization, you will be able to add the SimpleCitizen assessment as an Interview stage.

To do this for an existing job, navigate to a job (All Jobs>Job Name) and click Job Setup from the Job navigation bar.


From the Job Setup page, navigate to Interview Plan on the left-hand panel. Scroll down the page and click + Add a Stage.


From the Add Stage dialog box, select the SimpleCitizen stage. When finished, click Add to apply the stage to the job's interview plan.



Configure SimpleCitizen Stage

Once the stage has been added to the job's interview plan, click Edit Take Home Test. Use the provided drop-down menu to choose assessments that you have previously set up in SimpleCitizen.

Select the appropriate assessment and assign at least one Greenhouse user to grade/review submitted assessments. When finished, click Save.

Note: Keep in the mind that all configuration of the assessment itself, as well as the email template, is done prior in SimpleCitizen.


Send and Review the Test

When candidates are moved into the SimpleCitizen interview stage, Greenhouse will display a Send Test link.

Note: When you send a test from Greenhouse, the interview instructions are actually sent by SimpleCitizen.

The status of the assessment will be viewable in Greenhouse:

Once the candidate has submitted their test, the assigned grader can view a link to view the submitted test on SimpleCitizen.

After you click the link, you will be taken to a page where the URL is available to view the test results and review answers on SimpleCitizen. Click on the paper icon to the right to review assessment answers.

Note: You will only have access to the test results and assessment answers if you have permission to view them within SimpleCitizen.  Contact if you are having issues viewing assessment results within SimpleCitizen.