's integration with Greenhouse Recruiting allows your organization to sync your jobs to and import candidates to Greenhouse Recruiting.

Set up the integration

Retrieve a user ID requires a Greenhouse Recruiting user ID to associate with the integration requests. It's recommended to create a new integration system user (ISU) in Greenhouse Recruiting specifically for the integration. However, you can also find an existing user ID to authenticate the integration requests.

Copy the user ID for use in a later step.

Create a Harvest API key

Next, create a Harvest API key. Follow the steps in this article to create the key. In the Create New Credential box, make the following selections:

  • API type: Harvest
  • Partner:
  • Description: Harvest API key

Verify that the following permissions are selected for the integration:


  • Select all


  • Select all

Custom fields

  • Select all


  • Select all

(Optional) Create a custom candidate field for a secondary source

If you'd like to have the original source of the candidate displayed in Greenhouse Recruiting, your organization can create a custom candidate field to capture the platform from which the candidate originated — for instance Indeed or LinkedIn.

Note: To create a custom candidate field, you'll need to be a Site Admin or Job Admin who can manage company metadata.

To use secondary sources, create a custom candidate field and use the following settings:

  • Field name: Join original source
  • Field type: Short textbox

After you create the custom candidate field, Greenhouse Recruiting will generate an immutable field key:

Screenshot of immutable field key

Copy the immutable field key for use in a later step.

Enable the integration

Enable the integration on by navigating to Settings > Integrations. Enter the information copied in the previous steps.

Use the integration

After setup and enablement of the integration, it can take 1 — 2 working days for all jobs to be indexed on and for the first applications to be sent to Greenhouse Recruiting.

To avoid duplicate applications in Greenhouse Recruiting, only new applications are imported. If you still have applications on that you would like to send to Greenhouse Recruiting, use the export functionality on

Once the integration is enabled:

  • Your jobs will be synchronized once a day, meaning that new jobs will be created and old jobs will be archived automatically. You're free to create additional jobs or edit the existing jobs on
  • New candidates that apply on will be sent to Greenhouse Recruiting at the time of application and will be updated if the candidate uploads more information.
  • Candidates received previously will not be sent to Greenhouse Recruiting to avoid duplication. If you want older candidates to be available on Greenhouse Recruiting, you can export them on
  • If a candidate applies to multiple positions, the candidates won't be duplicated in Greenhouse Recruiting.

Additional resources

Email or reach out to your account manager for help troubleshooting the integration.