---
title: "Setting up the Greenhouse integration"
slug: "setting-up-the-greenhouse-integration"
tags: ["greenhouse"]
updated: 2026-08-30T19:52:34Z
published: 2026-08-30T19:52:34Z
canonical: "docs.checkmate.tech/setting-up-the-greenhouse-integration"
---

> ## 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.

# Setting up the Greenhouse integration

[Video](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/setting_up_the_greenhouse_integration.mp4?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D) Integrating Greenhouse with Checkmate streamlines your candidate background screening process. Once set up, you can launch checks in Checkmate without leaving Greenhouse, and view the progress of checks directly within Greenhouse.

Before you begin

Checkmate integrations are configured at company level. To avoid any issues, we recommend completing the steps below using your company's Checkmate user account with the highest level of permissions.

Once you've completed setup, see [Candidate checks via Greenhouse](/v1/docs/candidate-checks-via-greenhouse) to get started.

## Enable the integration in Checkmate

1. While signed in to your Checkmate account, navigate to your company settings by clicking your initials in the upper-right corner and selecting **Company Settings**.

![01_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/01_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Navigate to the **Integrations** tab.

![02_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/02_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Use the search field to find the **Greenhouse** card, or scroll to find it.

![03_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/03_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Toggle the **Greenhouse** integration on.

![04_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/04_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Enter your email in the **Email** field.

![05_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/05_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Click **Log in to Greenhouse**.

![06_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/06_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Select the **Authorize using a service account** checkbox.

![07_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/07_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Click **Authorize**.

![08_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/08_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Your Greenhouse account is now connected to Checkmate. Next, you’ll need to configure two custom options in Greenhouse.

![09_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/09_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

## Completing the integration setup in Greenhouse

In order for the integration to work, two custom fields need to be created in Greenhouse.

1. In Greenhouse, click the **Settings** cog.

![10_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/10_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Select **Custom Options**.

![11_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/11_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Click **Applications**.

![12_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/12_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

1. Create two **Custom Options** in Greenhouse using the exact **Field Names** shown.

![13_setting_up_the_greenhouse_integration](https://cdn.document360.io/7b4c6a0d-ec3b-4e70-95f8-547fce240019/Images/Documentation/13_setting_up_the_greenhouse_integration.png?sv=2026-02-06&spr=https&st=2026-11-09T14%3A01%3A35Z&se=2026-11-09T15%3A01%3A35Z&sr=c&sp=r&sig=b8fsSMXccUBkdeD1rQdHVTW2at%2BOWZSDAEDrOasKeZM%3D)

Need help? Contact our support team at [team@checkmate.tech](mailto:team@checkmate.tech) and we'll be happy to assist.