Integrate with Greenhouse

Greenhouse is a hiring software company. With Greenhouse, you can: 

Gusto integrates with Greenhouse to import candidates and send an offer, or add them directly to your team as an employee or contractor. Additionally, if you send candidate offer letters with Greenhouse, the signed offer letters are included in the sync to Gusto.

The following is imported from Greenhouse:

Connect to Greenhouse from Gusto

You must have "Site Admin" and "Can manage ALL organization’s API Credentials" permissions in Greenhouse to proceed.

  1. Sign in to Gusto as an admin. 
  2. Go to the App directory.
  3. Click Hiring from the integration menu.
  4. Click Greenhouse.
  5. Click Connect.
  6. To obtain an API key from Greenhouse, click here to navigate directly to Greenhouse > Configure > Dev Center > API Credential Management.
  7. Click Create New API Key.
  8. In the popup, select Harvest as the type. 
  9. Skip the “Partner” field.
  10. Give your API Key a name (e.g. Gusto) in the "Description" field.
  11. Click Manage Permissions.
  12. Copy the API key somewhere safe–you'll paste this in Gusto shortly.
    • Important: After clicking "I have stored the API Key in the next step," you cannot access the full Harvest API key again. If you lose your API key, you must create a new API key and revoke access to the original key.
  13. Click I have stored the API key.
  14. Click the Select All checkbox under "Manage Permissions."
  15. Click Save.
  16. Copy the API key into Gusto.
  17. Click Continue to setup.

Your Greenhouse and Gusto accounts are now connected. You can view integration details in the About tab of the integration in your Gusto account.

Sync information from Greenhouse to Gusto

Once the integration is active, you can start importing candidates to hire to your team in Gusto.

To keep this integration fast, we do not include rejected candidates or candidates that have not been updated recently. If you’re not seeing a candidate, make sure they’ve had a recent update in Greenhouse.

  1. Go to the Hiring section.
  2. Click Import.
  3. Indicate whether the candidate should be imported as an employee or contractor. 
    • For Gusto customers on the Plus or Premium plan: indicate whether you want to send an offer letter.
  4. Click Continue
  5. Complete any remaining information needed for the new hire. 
    • Greenhouse will pre-populate some of this information for you.
    • Interview, scorecard, and notes will not transfer.
  6. Click Save & continue.

All that’s left is to add the employee to payroll

Include candidate start dates in syncing

The integration supports a sync for start date when it's configured as a custom field. To import a candidate's start date, the field name in Greenhouse must be "start_date" with a "date" value type. Additional custom fields are not supported at this time.

Still need help? 

Check out Greenhouse’s Help Center or contact us from the Help section of your Gusto account.