Greenhouse (Harvest API)

Access the Greenhouse Harvest API in 2 minutes 💨

🚀 Quickstart

1. Create an integration

   In Nango (free signup), go to Integrations -> Configure New Integration -> Greenhouse (Harvest API).

2. Authorize Greenhouse

   Go to Connections -> Add Test Connection -> Authorize, then enter your Greenhouse Harvest credentials. Later, you’ll let your users do the same directly from your app.

3. Call the Greenhouse Harvest API

   Let’s make your first request to the Greenhouse Harvest API (fetch a list of organization’s candidates). Replace the placeholders below with your secret key, integration ID, and connection ID:

   cURL

   curl -X GET "https://api.nango.dev/proxy/v1/candidates?per_page=10" \
     -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
     -H "Provider-Config-Key: <INTEGRATION-ID>" \
     -H "Connection-Id: <CONNECTION-ID>"
   

   Node

   Install Nango’s backend SDK with npm i @nangohq/node. Then run:

   import { Nango } from '@nangohq/node';
   
   const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
   
   const res = await nango.get({
     endpoint: '/v1/candidates',
     params: {
       per_page: 10
     },
     providerConfigKey: '<INTEGRATION-ID>',
     connectionId: '<CONNECTION-ID>'
   });
   
   console.log(JSON.stringify(res.data, null, 2));
   

   Or fetch credentials dynamically via the Node SDK or API.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Greenhouse accounts.

🔗 Useful links

Topic	Links
Authorization	Guide to connect to Greenhouse Harvest API using Connect UI
General	Greenhouse Website
	Greenhouse Dashboard
Developer	Authentication docs
	Harvest API Docs
	Rate Limiting

Contribute useful links by editing this page

🚨 API gotchas

None yet, add yours!

Contribute API gotchas by editing this page

Questions? Join us in the Slack community.