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.
🚀 Quickstart
🧑💻 OAuth app setup
🔗 Useful links
🚨 API gotchas
Create an integration
In Nango (free signup), go to Integrations -> Configure New Integration -> Greenhouse (OAuth). Nango doesn’t provide a test OAuth app for Greenhouse (OAuth) 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 API
Let’s make your first request to the Greenhouse API. If you have api as your Greenhouse API Domain, this will 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 that Greenhouse will include in their 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 |
