This page contains the setup guide and reference information for the Greenhouse source connector.
Please follow the Greenhouse documentation for generating an API key.
- Log into your Airbyte Cloud account.
- In the left navigation bar, click Source. In the top-right corner, click +new source.
- On the Set up the source page, enter the name for the Greenhouse connector and select Greenhouse from the Source type dropdown.
- Enter your
api_key - Click Set up source
- Navigate to the Airbyte Open Source dashboard
- Set the name for your source
- Enter your
api_key - Click Set up source
The Greenhouse source connector supports the following sync modes:
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | Yes |
| Replicate Incremental Deletes | Coming soon |
| SSL connection | Yes |
| Namespaces | No |
- Applications
- Applications Interviews
- Candidates
- Close Reasons
- Custom Fields
- Degrees
- Departments
- Interviews
- Job Posts
- Job Stages
- Jobs
- Jobs Openings
- Jobs Stages
- Offers
- Rejection Reasons
- Scorecards
- Sources
- Users
You can specify which API endpoints your API keys have access to from the Greenhouse Dev Center. This will allow you to permit or deny access to each endpoint individually. Any API keys created before January 18th, 2017 will have full permissions to all API endpoints that existed at that time, but any new API keys created after that point will need to be explicitly granted the required endpoint permissions. To add or remove endpoint permissions on an API key, go to the Dev Center in Greenhouse, click “API Credential Management,” then click “Manage Permissions” next to your Harvest API Key. From there, check or uncheck permissions for any endpoints.
Important Note: Users with Harvest API keys may access all the data in the endpoint. Access to data in Harvest is binary: everything or nothing. Harvest API keys should be given to internal developers with this understanding and to third parties with caution. Each key should only be allowed to access the endpoints it absolutely needs. See more on this here.
The Greenhouse connector should not run into Greenhouse API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.3.0 | 2022-10-19 | 18154 | Extend Users stream schema |
| 0.2.11 | 2022-09-27 | 17239 | Always install the latest version of Airbyte CDK |
| 0.2.10 | 2022-09-05 | 16338 | Implement incremental syncs & fix SATs |
| 0.2.9 | 2022-08-22 | 15800 | Bugfix to allow reading sentry.yaml and schemas at runtime |
| 0.2.8 | 2022-08-10 | 15344 | Migrate connector to config-based framework |
| 0.2.7 | 2022-04-15 | 11941 | Correct Schema data type for Applications, Candidates, Scorecards and Users |
| 0.2.6 | 2021-11-08 | 7607 | Implement demographics streams support. Update SAT for demographics streams |
| 0.2.5 | 2021-09-22 | 6377 | Refactor the connector to use CDK. Implement additional stream support |
| 0.2.4 | 2021-09-15 | 6238 | Add identification of accessible streams for API keys with limited permissions |