--- title: "Candidate checks via Greenhouse" slug: "candidate-checks-via-greenhouse" tags: ["greenhouse"] updated: 2026-08-30T19:52:42Z published: 2026-08-30T19:52:42Z canonical: "docs.checkmate.tech/candidate-checks-via-greenhouse" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.checkmate.tech/docs/llms.txt > Use this file to discover all available pages before exploring further. # Candidate checks via Greenhouse [Video](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/candidate_checks_via_greenhouse.mp4?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) Once the Greenhouse integration is set up, you can launch background checks and track their progress without leaving Greenhouse. If you haven't set up the integration yet, see [Setting up the Greenhouse integration](/v1/docs/setting-up-the-greenhouse-integration) before continuing. ## Add the Background Check stage to a job Before you can launch checks within Checkmate, you'll need to add the Background Check stage to the job. 1. Select a job from the **Jobs** page. ![01_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/01_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Select **Interview Plan** from the **Job Setup** menu. ![02_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/02_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Edit stages**. ![03_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Add stage**. ![04_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. The stage must be named **Background Check** exactly, as the name is case-sensitive. If a stage with this name already exists, select it. Otherwise, create a new stage. ![05_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/05_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Add**. ![06_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/06_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Save**. ![07_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/07_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Confirm and save**. ![08_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/08_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) ## Launch checks within Greenhouse 1. Click **Candidates** in the navigation menu. ![09_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/09_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Select the candidate you want to launch background checks for. ![10_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/10_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click **Move stage**. ![11_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/11_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Select the **Background Check** stage. ![12_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/12_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. Click the **Checkmate URL**. ![13_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/13_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) 1. The Checkmate window will open in a new tab, prompting you to select your desired background checks. 2. Select the **Bundle** or individual checks you'd like to launch. If your organisation has more than one brand, select the appropriate **Brand**. 3. Once you've selected your checks and configured any options for those checks, scroll down and click **Launch Checks**. Tip Bundles are a quick and easy way to launch multiple checks for a candidate at once. [Learn more about bundles.](https://docs.checkmate.tech/docs/creating-and-launching-bundles) ![Checks Selector](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/02_widget_checks_selector.gif?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) ## Monitor progress 1. Click the **Checkmate URL** at any time to open Checkmate and view the order’s progress. ![14_candidate_checks_via_greenhouse](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/14_candidate_checks_via_greenhouse.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) The following 3 tabs allow you to view progress and edit candidate details: **Background Checks** - From here you can view the status of the check, add additional checks using the **Add Checks** button and download results when checks are complete. **Candidate** - This tab allows you to update the candidate's details at any time during the background check process. **History** - This tab shows a chronological log of events related to the candidate's background screening process. ![3 Candidate profile tabs](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_widget_monitoring_progress.gif?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) ## View results Result files can be downloaded via the **Background Checks** tab when the check has been completed. ![View results](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_widget_view_results.png?sv=2026-02-06&spr=https&st=2026-11-09T13%3A53%3A24Z&se=2026-11-09T14%3A53%3A24Z&sr=c&sp=r&sig=QXrBZUobjY2LXvbIEUDfaLo9x%2BEOFC9x4tyt9tci%2Flk%3D) Need help? Contact our support team at [team@checkmate.tech](mailto:team@checkmate.tech) and we'll be happy to assist.