Prerequisites

Before getting started, please carefully read the following to make sure you fulfill all requirements for the integration to work:

• Greenhouse user permissions required:
  • Developer Permissions
    • Manage ALL organization's API Credentials
      
  • User-Specific Permissions
    
    • Manage CRM (Only if candidate source writing is enabled)
      
• Your Greenhouse admin can grant you the appropriate permissions.

1. Log in to Greenhouse, then click on the cog in the top right corner:
    
2. Go to "Dev Center" in the left menu:
    
3. In order to be able to complete the setup process, you should be able to see the "API Credential Management" item:
   
    
4. If you can not see this item, ask your Greenhouse account admin to take over the setup process, or to grant your user the "Manage ALL organization's API Credentials" permission. Without this permission, the setup process can not be completed.

Who is your Greenhouse account Administrator?

1. Go to the main Greenhouse dashboard.
2. Click on "Email Your In-House Contacts" under "Helpful Links":
   

Generate your API credentials

1. Log into your Greenhouse account and click on the cog in the top right corner:
   
    
2. Go to the "Dev Center":
   
    
3. Click on "API Credential Management":
   
    
4. Click on "Create New Api Key":
   
    
5. Enter the following details:
   • API Type: Harvest
   • Partner: Custom
   • Description: *Your Integration Name* (Preferably the value you copied earlier)
     
      
6. Copy your created API key and the paste the value into the connection flow:
   
7. Next, under "Manage permissions", select all the required permissions under Harvest V1.
   
   
   You can find all the required permissions listed in the connection flow:
   
   The list of permissions here is only an example. Please check your own permissions in the connection flow.
   
   Once you filled in all the required permissions in Greenhouse, press "Save".

8. After confirming the connection, you will be prompted to also set up Webhooks. For this, from the "Dev Center", navigate to "Webhooks" > "Webhooks"

There, enter the values as provided to you by the connection flow.

Keep in mind that you will have to fill out this form multiple times, once for every event type requested by the flow.

Tip: Greenhouse might not show the newly added Webhook in the list right after saving. Only after reloading the page next time will it show up. However don't worry, it is still saved.