Kula is a recruitment automation platform that lets you proactively reach out and engage with the top talent everywhere. With Kula, you have complete control, visibility, and predictability on your entire talent pipeline.

Greenhouse Recruiting’s integration with Kula enables your organization to do the following:

  • Associate each outreach with a job in Greenhouse Recruiting
  • Automatically create applications when a candidate is added to an outreach
  • Maintain bi-directional stage sync between Kula and Greenhouse Recruiting
  • Create applications and keep stages in-sync when a candidate is vouched in Kula
  • Import candidates from Greenhouse Recruiting and track them in Kula for historical context

Create a Harvest API Key for the Kula Integration

You'll need to create a Harvest API Key to configure the Greenhouse Recruiting / Kula integration. Follow the steps in this article to create the key, and verify that the permissions below are selected when configuring the Kula integration. Make sure you copy the API key you create in Greenhouse Recruiting as you will need to paste it in Kula after you generate it.


In the Create New Credential box, make the following selections:

  • API Type: Harvest
  • Partner: Kula (optional)
  • Description: Kula Harvest API Key


Verify that the following permissions are selected for the Kula integration:


  • GET: Retrieve Application
  • GET: List Applications
  • POST: Hire Application
  • POST: Move Application
  • POST: Reject Application
  • POST: Unreject Application
  • POST: Add Attachment to Application
  • PATCH: Update a rejected application's rejection reason


  • GET: Retrieve Candidate
  • GET: List Candidates
  • POST: Add Candidate
  • POST: Add Note
  • POST: Add Application


  • GET: Retrieve User
  • GET: List Users


  • GET: Retrieve Department
  • GET: List Departments


  • GET: Retrieve Job
  • GET: List Jobs

Job Stages

  • GET: Retrieve Job Stage
  • GET: List Job Stages
  • GET: List Job Stages for Job


  • GET: Retrieve Office
  • GET: List Offices

Rejection Reasons

  • GET: List Rejection Reasons


  • GET: List Sources

Custom Fields

  • GET: Get custom fields

Custom Field Options

  • GET: Custom field options

Configure the Greenhouse Recruiting Integration in Kula

Once you've completed the above steps in Greenhouse Recruiting, complete the following steps in Kula.

Navigate to the Settings page by clicking your profile picture, then Settings.

Click Organization, then Integrations. Next to Greenhouse, click the Setup toggle.

In the Add Integration pop-up, enter the Harvest API Key that you created in Greenhouse Recruiting and the Greenhouse Base URL.

Note: The Greenhouse Base URL should be copied from the address bar of the Greenhouse Recruiting page you used to create the Harvest API Key. In this example, the base URL would be app4.greenhouse.io.

Once the integration is added, it may take some time for Greenhouse Recruiting data such as candidates, jobs, departments, and other information to be imported into Kula.

Greenhouse Recruiting / Kula candidate stage mapping

From the Settings page, click Organization, then Integrations. Below Greenhouse, click Configure.

In the Configure Integration pop-up that appears, you can view and edit how stages from Greenhouse Recruiting map to Candidate stages in Kula and vice versa.

Please verify that the mappings are correct for your organization and edit them as needed.

Note: If your Greenhouse Recruiting account does not use custom stages, the default mappings provided by Kula should work out-of-the-box in most cases.

Use the Kula integration with Greenhouse Recruiting

Associate an outreach with a job in Greenhouse Recruiting

Once you successfully connect your Greenhouse Recruiting account with your Kula account, you can now associate any outreach in Kula with a job in Greenhouse Recruiting. This will allow you to sync candidates and their stages bi-directionally. Select the job from the Applicant Tracking System dropdown to associate the outreach with a job in Greenhouse Recruiting.

Add candidates to a job in Greenhouse Recruiting

After you associate an outreach with a job in Greenhouse Recruiting, any candidate you add to your Kula outreach will be available as a candidate in the linked job in Greenhouse Recruiting. You can confirm this in two ways:

In Kula, a Greenhouse icon appears next to the candidate's name.

In Greenhouse Recruiting, the candidate appears in the Candidates list for the job.

Bi-directional sync of candidate stages

Candidates synced between Kula and Greenhouse Recruiting progress through the stages that were mapped when the integration was configured. For example, when you move a candidate to Offer stage in Kula, the candidate will also move to Offer stage in Greenhouse Recruiting.

Syncing intros and referrals from Kula to Greenhouse Recruiting

Intros and candidate referrals are synced between Kula and Greenhouse Recruiting. Similar to an outreach, when a candidate intro or referral is added to Kula, the candidate is also added in Greenhouse Recruiting. Greenhouse Recruiting will also reflect that the candidate has been referred by a specific user.

Additional resources

If you need help or additional information, visit the Kula Help Center or reach out to support@kula.ai.