Greenhouse (Onboarding API)

🚀 Quickstart
🔗 Useful links
🚨 API gotchas

Create an integration

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

Authorize Greenhouse

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

Call the Greenhouse Onboarding API

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

cURL
Node

curl -X POST "https://api.nango.dev/proxy/graphql" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { locations(first: 10) { pageInfo { hasNextPage endCursor } edges { node { id name address externalId } } } }"
  }'

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.post({
  endpoint: '/graphql',
  providerConfigKey: '<PROVIDER-CONFIG-KEY>',
  connectionId: '<CONNECTION-ID>',
  data: {
    query: `query { locations(first: 10) { pageInfo { hasNextPage endCursor } edges { node { id name address externalId } } } }`
  }
});

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.

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

Contribute useful links by editing this page

Questions? Join us in the Slack community.

Greenhouse (Job Board API)Grafana

⌘I

Overview

900+ APIs & Integrations

Greenhouse (Onboarding API)