Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Greenhouse (Ingestion API). Nango doesnât provide a test OAuth app for Greenhouse (Ingestion API) yet, so youâll need to set up your own by following these instructions. After that, make sure to add the OAuth Client ID, Client Secret, and scopes in the integration settings in Nango. Authorize Greenhouse
Go to Connections -> Add Test Connection -> Authorize, then log in to Greenhouse. Later, youâll let your users do the same directly from your app. Call the Greenhouse Ingestion API
Letâs make your first request to the Greenhouse Ingestion API (fetch the profile of the currently signed-in user). Replace the placeholders below with your secret key, integration ID, and connection ID:curl -X GET "https://api.nango.dev/proxy/v1/partner/current_user" \
-H "Authorization: Bearer <NANGO-SECRET-KEY>" \
-H "Provider-Config-Key: <INTEGRATION-ID>" \
-H "Connection-Id: <CONNECTION-ID>"
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/partner/current_user',
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data, null, 2));
Next step: Embed the auth flow in your app to let your users connect their Greenhouse accounts. Submit application information to Greenhouse
Contact Greenhouse to register your OAuth application. Youâll need to provide:
- Application Name: The name of your application as it will appear in Greenhouse
- Application URL: The URL of your application
- Callback URL: Use
https://api.nango.dev/oauth/callback
- Logo Image: A 128x128 pixel image for Greenhouseâs permissions modal
Receive OAuth credentials from Greenhouse
After submitting your application information, Greenhouse will provide:
- Consumer Key: Uniquely identifies your application
- Consumer Secret: Acts as proof of your applicationâs identity (will be encrypted when emailed)
The consumer secret is confidential and will be encrypted by Greenhouse for security. Theyâll provide decryption instructions.
Common Scopes
| Scope | Description |
|---|
candidates.create | Create new candidates or prospects |
candidates.view | View candidates imported via this partner |
jobs.view | View my jobs |
