Before you begin

You must be a Greenhouse administrator to create an API key

Need help? Let eqtble set up Greenhouse for you. We will schedule a call with whoever is the Greenhouse admin on your side.

Note on security

eqtble only requires a Read-Only API key and will not have the ability to modify data in your Greenhouse account. See the Greenhouse docs for more info. We always recommend creating a new API key for eqtble. This will allow you to revoke access to eqtble if needed.

Integrate eqtble with Greenhouse Harvest API

  1. Sign in to Greenhouse Recruiting
  2. Click the Configure icon on your navigation bar.
  3. Click Dev Center

If you do not see this, you need to be given developer permissions from a Greenhouse admin

  1. Click API Credential Management.

If this option does not appear, you will need to request from Greenhouse Support to turn on API management for your company

  1. Click Create new API key button to generate the API key.
  2. In the Create New Credential dialog box, make the following selections:
  • API Type: Harvest API
  • Partner: eqtble
  • Description: eqtble integration
  1. Click Manage permissions
  2. Click Copy to copy the API key to your clipboard. Save the API key in a secure location.
  3. Click I have stored the API key.
  4. The API key will be created and you will be navigated to the permissions page.
  5. Make sure all GET permissions are checked. and click Save.
  6. Login to the eqtble app.
  7. Navigate to Organization Settings.
  8. Select Integrations and select Greenhouse
  9. Paste the API key into the API Key field and click Save.
  10. Make sure you have your API key copied to a secure location and copy the Webhook endpoint. You will need these in the next step.

Set up required Webhooks

eqtble leverages Greenhouse’s webhooks to capture application, candidate process, and offer history. This allows us to provide you with a complete picture of your candidate’s journey.

Information We’ll Need

  • Endpoint URL
    • This will be provided by eqtble once we have received the API key
  • Secret Key (this is the Harvest API Key that we saved in the previous steps)

Setup

  1. Sign in to Greenhouse Recruiting
  2. Click the Configure icon on your navigation bar.
  3. Click Dev Center

If you do not see this, you need to be given developer permissions from a Greenhouse admin

  1. Click Web Hooks

If this option does not appear, you will need to request from Greenhouse Support to turn on Webhooks for your company

  1. Click Web Hooks
  2. You will see a list of webhooks that are currently active and a form to create a new webhook.

Add the following webhooks

eqtble requires the following webhooks to be created and active:

  1. Candidate has submitted application
  2. Candidate has been hired
  3. Candidate has changed stage
  4. Candidate has been unhired
  5. Candidate or prospect rejected
  6. Candidate or prospect unrejected

For each webhook outlined above, fill in the following fields:

  1. Name this webhook: eqtble - name of webhook
  2. When: The webhook event outlined above
  3. Endpoint URL: The webhook endpoint you copied from the eqtble app
  4. Secret Key: The API key you created and saved in the previous steps
  5. Error recipient email: you can leave this blank - we will be notified of errors if it doesn’t work.
  6. Disabled?: No

Click Create Webhook to save the webhook and enable it.

Note on the Webhook endpoint

When you create a new webhook, Greenhouse Recruiting tries and verifies that the connection is working. If this ping is accepted successfully, the endpoint will be created. If the ping is unsuccessful, Greenhouse Recruiting will save the configurations but disable the webhook. If the webhook is disabled because the endpoint ping failed, edit the web hook’s configuration and fix the error. To re-enable the webhook to try again, change the Disabled? section to No and click Update Web hook.

If you’re still having trouble, contact eqtble support and we’ll help you troubleshoot.

Did we miss something? Have a question? Email us at integrations@eqtble.com to let us know.