# Greenhouse
The Greenhouse integration allows you to manage your entire hiring process from one central tool. Jobs created in Greenhouse are automatically synced to JOIN and published on job boards. When candidates apply, JOIN collects their applications and sends them straight into Greenhouse—so you can keep using your ATS while JOIN takes care of distribution.
{% hint style="warning" %}
Before you begin, make sure to review the [External HR tools](https://help.join.com/integrations/external-hr-tools) article to understand the general requirements and limitations that apply to all integrations (e.g. sync frequency, job limits, multi-language/locations, screening questions).
{% endhint %}
Once connected, the Greenhouse integration allows you to:
* Automatically sync jobs from Greenhouse to JOIN for multiposting
* Receive applications from JOIN directly into Greenhouse in real time
* Keep Greenhouse as your main ATS while JOIN handles the outreach
***
### Connect Greenhouse and JOIN
{% stepper %}
{% step %}
#### **Check your Greenhouse permissions**
To enable the integration, you need Site Admin rights in Greenhouse:
1. In Greenhouse, click the gear icon in the top-right
2. Go to `Users`, find and select your profile
3. Scroll to the `Permissions` section
4. Confirm that `Site Admin` access is enabled. If not, ask a colleague with Site Admin rights to grant you access
{% endstep %}
{% step %}
#### Get your Greenhouse User ID
JOIN uses your Greenhouse User ID to identify your ATS account:
1. Go to `Configure` → `Users`
2. Click `Export to Excel`
3. Open the file and find your `User ID` in the first column
4. You’ll enter this in JOIN under `ATS Identifier`
{% endstep %}
{% step %}
#### Create a Harvest API key
1. Go to `Configure` → `Dev Center` → `API Credentials`
2. Click `Create New API Key`
3. Choose `Harvest API` as the type and name it (e.g. “JOIN Integration”)
4. Click save and copy the API Key
{% endstep %}
{% step %}
#### Add a custom candidate field (optional)
To show the original source of candidates in Greenhouse (e.g. Indeed, LinkedIn):
1. Go to `Configure` → `Custom Options` → `Company Custom Fields` → `Candidates`
2. Click `Add Field` and name the field (e.g. “JOIN Original Source”)
3. Set the type to `Short textbox`
4. Save and copy the `Immutable Field Key` at the bottom
You’ll later enter this key in JOIN under `Job Board Name`.
{% endstep %}
{% step %}
#### Sync only selected jobs (optional)
{% hint style="info" %}
By default, all jobs published in Greenhouse (within your JOIN job limit) will sync. If you want to sync only selected jobs, you can configure this directly in Greenhouse using a custom job field.
{% endhint %}
To filter which jobs sync:
* Add a custom job field in Greenhouse (e.g. “Promote on JOIN”)
* Use this field per job to indicate if it should sync
* Ensure jobs are marked 'Expose in Job Board API = Yes'
This filtering setup is fully managed within Greenhouse. No action is required in JOIN.
{% endstep %}
{% step %}
#### Enter your Greenhouse details in JOIN
1. Go to `Settings` → `Integrations` → `Greenhouse`
2. Enter the following:
* **Subdomain** → your Greenhouse career page subdomain\
(Format: `https://boards.greenhouse.io/[subdomain]`)
* **ATS Identifier** → your Greenhouse User ID
* **API Token** → your Harvest API Key
* **Job Board Name** (optional) → Immutable Field Key (if using custom candidate field)
3. Click `Request` in the top-right corner
Our team will activate the integration within 1 business day. You'll receive a confirmation email once everything is live.
{% endstep %}
{% endstepper %}
***
### Screening questions
{% hint style="info" %}
[Screening questions](#user-content-fn-1)[^1] are not supported by default in the Greenhouse integration.
{% endhint %}
However, we can enable hardcoded screening questions across your account on request. Here's how it works:
* Questions apply to *all synced jobs* (not on a per-job basis)
* You must provide:
* Question text
* Answer options
* Whether each answer should be mandatory or optional
* Candidate responses will appear in Greenhouse as notes or messages, not structured fields
* [Knockout questions](https://help.join.com/jobs/job-creation#to-create-a-custom-screening-question) are not supported
{% hint style="warning" %}
Screening questions must be defined at the account level and cannot be customised per job.
{% endhint %}
***
### FAQs
Can I manage or edit synced jobs directly in JOIN?
No. You should manage all job content and status directly in Greenhouse. Editing or archiving a synced job in JOIN may disrupt the sync.
What happens if I archive a synced job in JOIN?
If you archive a synced job (labeled `Synced` with a green checkmark :circle-check:) directly in JOIN, it will stop syncing permanently unless you restore it from the `Archived` jobs tab.
How often does JOIN sync with Greenhouse?
Jobs sync every 30–60 minutes. Applications are delivered to Greenhouse in real time.
Can I choose which jobs to sync from Greenhouse?
Yes. You can set up a custom job field in Greenhouse to control which jobs sync. JOIN respects this setting automatically.
[^1]: Screening questions are custom or pre-set questions included in the application form to help you gather important information from candidates early in the hiring process. These questions can cover availability, skills, experience, or qualifications — making it easier to identify strong matches right from the start. By filtering out unsuitable applicants early on, they help streamline your recruitment process and focus your attention on the most relevant candidates.
[#screening-questions](https://help.join.com/jobs/job-creation#screening-questions "mention")
