Skip to main content

Overview

To authenticate with Greenhouse (Basic Auth), you need:
  1. Greenhouse API Domain - This is the domain to the Greenhouse API product you would wish to connect to.
  2. API Key - Your Greenhouse API Key.
This guide will walk you through finding or generating these credentials within Greenhouse.

Prerequisites:

  • You must have an account with Greenhouse.

Step 1: Finding your Greenhouse API Domain

  • Your API domain refers to the base domain for the specific Greenhouse API product you’re using. For the Harvest API, this is harvest.

Step 2: Generating Your Greenhouse API Key

  1. Log into your Greenhouse account and click the Configure ⚙️ icon on your navigation bar, then click Dev Center.
  1. Click API Credential Management.
  1. Click Create New API Key.
  1. Make the following selections:
    • API type: Job board (This is the Greenhouse API product you’re using)
    • Description: Give your API Key a descriptive name
  2. When finished, click Manage permissions, or click Create to generate the API Key and automatically assign it the appropriate permissions required by the integration.
  3. After the key is created, click Copy. Paste the API Key in a secure location.
  4. Click I have stored the API Key to finish generating your API Key

Step 3: Connect Your Greenhouse Account

Once you have your Greenhouse API Domain and API Key:
  1. Open the form where you need to authenticate with Greenhouse (Basic auth).
  2. Enter your Greenhouse API Domain and API Key in their respective fields.
  3. Submit the form, and you should be successfully authenticated.
You are now connected to Greenhouse (Basic Auth).
I