Greenhouse

Set up the Greenhouse integration to sync jobs to JOIN for multiposting and send applications back to 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.

Before you begin, make sure to review the 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).

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

1

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

2

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

3

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

4

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.

5

Sync only selected jobs (optional)

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.

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.

6

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.

---

Screening questions

are not supported by default in the Greenhouse integration.

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 are not supported

Screening questions must be defined at the account level and cannot be customised per job.

---

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