Greenhouse API Directory

Greenhouse software is a leading applicant tracking system (ATS) and recruiting platform designed to enhance the recruitment process for organizations of all sizes. By offering a comprehensive suite of tools, Greenhouse streamlines the entire hiring workflow, from sourcing candidates to managing applications and coordinating interviews. This robust software empowers human resources and recruitment teams to collaborate effectively, ensuring a seamless and efficient hiring process. With its focus on data-driven decision-making, Greenhouse provides valuable insights through recruiting metrics, enabling organizations to optimize their recruitment strategies and improve overall hiring outcomes.

A key feature of Greenhouse is its ability to integrate seamlessly with other platforms through the Greenhouse API. This integration capability allows businesses to customize and extend the functionality of the software, ensuring it meets their unique recruitment needs. By leveraging the Greenhouse API, organizations can automate various aspects of the recruitment process, enhance data sharing across systems, and create a more cohesive and efficient hiring ecosystem. As a result, Greenhouse not only simplifies recruitment but also fosters a more strategic approach to talent acquisition.

Key Highlights of Greenhouse APIs

1. Easy Data Access:
- Facilitates seamless data flow into and out of the platform.
2. Custom Integration:
- Allows for tailored integrations to fit specific hiring workflows.
3. Real-Time Sync:
- Typically supports real-time data synchronization.
4. Strong Security:
- Implements security measures to protect data and ensure secure access.
5. Scalable:
- Designed to handle varying loads, suitable for different users and organizations.
6. Developer-Friendly:
- Accessible to developers with documentation and support.
7. Global Support:
- Accommodates international users and functions across regions.
8. Error Handling and Logging:
- Includes features for robust error handling.
9. Rate Limiting:
- Prevents abuse and ensures fair usage.
10. Version Control:
- Manages changes and updates without disrupting existing integrations.
11. Data Transformation:
- Allows manipulation of data formats as needed.
12. Webhook Support:
- Enables real-time notifications and updates.
13. Detailed Analytics and Reporting:
- Provides insights into hiring processes and data usage.
14. Sandbox Environment:
- Allows testing of integrations and features without affecting live data.

Greenhouse API Endpoints

General

POST https://api.example.com/greenhouse/test : Test Greenhouse API
POST https://api.example.com/v1/sample : Sample API

Applications

POST https://api.greenhouse.io/v1/applications/{application_id}/advance : Advance Application
GET https://harvest.greenhouse.io/v1/applications/{application_id}/offers : List Offers Associated with an Application
GET https://harvest.greenhouse.io/v1/applications/{application_id}/offers/current_offer : Fetch Current Offer for Application
GET https://harvest.greenhouse.io/v1/applications/{id} : Retrieve Application by ID
PATCH https://harvest.greenhouse.io/v1/applications/{id}/convert_prospect : Convert Prospect Application to Candidate
GET https://harvest.greenhouse.io/v1/applications/{id}/demographics/answers : List Demographic Answers for an Application
GET https://harvest.greenhouse.io/v1/applications/{id}/eeoc : Retrieve Application EEOC Data
POST https://harvest.greenhouse.io/v1/applications/{id}/hire : Hire Application
POST https://harvest.greenhouse.io/v1/applications/{id}/move : Move Application Between Stages
PATCH https://harvest.greenhouse.io/v1/applications/{id}/offers/current_offer : Update Current Offer on Application
POST https://harvest.greenhouse.io/v1/applications/{id}/reject : Reject Application
GET https://harvest.greenhouse.io/v1/applications/{id}/scheduled_interviews : Get Scheduled Interviews for an Application
GET https://harvest.greenhouse.io/v1/applications/{id}/scorecards : List All Submitted Scorecards for an Application
POST https://harvest.greenhouse.io/v1/applications/{id}/transfer_to_job : Transfer Application to Different Job Stage
POST https://harvest.greenhouse.io/v1/applications/{id}/unreject : Unreject Application

Approval Flows

GET https://harvest.greenhouse.io/v1/approval_flows/{id} : Retrieve Approval Flow
POST https://harvest.greenhouse.io/v1/approval_flows/{id}/request_approvals : Request Approval Flow Start

Approver Groups

PUT https://harvest.greenhouse.io/v1/approver_groups/{approver_group_id}/replace_approvers : Replace Approvers in Approver Group

Candidates

POST https://harvest.greenhouse.io/v1/candidates : Create a New Candidate
PUT https://harvest.greenhouse.io/v1/candidates/merge : Merge Two Candidates
DELETE https://harvest.greenhouse.io/v1/candidates/{candidate_id}/educations/{education_id} : Delete Education Record by Candidate and Education ID
DELETE https://harvest.greenhouse.io/v1/candidates/{candidate_id}/employments/{employment_id} : Delete Employment Record
PUT https://harvest.greenhouse.io/v1/candidates/{candidate_id}/tags/{tag_id} : Apply a Tag to a Candidate
DELETE https://harvest.greenhouse.io/v1/candidates/{id} : Delete Candidate by ID
POST https://harvest.greenhouse.io/v1/candidates/{id}/activity_feed/emails : Create Candidate Email Note
POST https://harvest.greenhouse.io/v1/candidates/{id}/activity_feed/notes : Create Candidate Note
PUT https://harvest.greenhouse.io/v1/candidates/{id}/anonymize?fields={field_names} : Anonymize Candidate Data
POST https://harvest.greenhouse.io/v1/candidates/{id}/attachments : Post Attachment to Candidate Profile
POST https://harvest.greenhouse.io/v1/candidates/{id}/educations : Create a New Education Record for a Candidate
POST https://harvest.greenhouse.io/v1/candidates/{id}/employments : Create a New Employment Record
GET https://harvest.greenhouse.io/v1/candidates/{id}/tags : Retrieve Candidate Tags

Close Reasons

GET https://harvest.greenhouse.io/v1/close_reasons : List Organization's Close Reasons

Custom Fields

GET https://harvest.greenhouse.io/v1/custom_field/{id} : Get Custom Field by ID
DELETE https://harvest.greenhouse.io/v1/custom_field/{id}/custom_field_options : Destroy Custom Field Options
POST https://harvest.greenhouse.io/v1/custom_fields : Create Custom Fields in Greenhouse
GET https://harvest.greenhouse.io/v1/custom_fields/{field_type} : Get Custom Fields
DELETE https://harvest.greenhouse.io/v1/custom_fields/{id} : Delete Custom Field

Degrees

GET https://harvest.greenhouse.io/v1/degrees : Retrieve All Degree and Education Levels

Demographics

GET https://harvest.greenhouse.io/v1/demographics/answer_options : List Organization's Demographic Answer Options
GET https://harvest.greenhouse.io/v1/demographics/answer_options/{id} : Retrieve Demographic Answer Option by ID
GET https://harvest.greenhouse.io/v1/demographics/answers : List Organization's Demographic Answers
GET https://harvest.greenhouse.io/v1/demographics/answers/{id} : Retrieve Demographic Answer by ID
GET https://harvest.greenhouse.io/v1/demographics/question_sets : List Organization's Demographic Question Sets
GET https://harvest.greenhouse.io/v1/demographics/question_sets/{id} : Retrieve Demographic Question Set by ID
GET https://harvest.greenhouse.io/v1/demographics/question_sets/{id}/questions : List Demographic Questions for a Question Set
GET https://harvest.greenhouse.io/v1/demographics/questions : List Organization's Demographic Questions
GET https://harvest.greenhouse.io/v1/demographics/questions/{id} : Retrieve Demographic Question by ID
GET https://harvest.greenhouse.io/v1/demographics/questions/{id}/answer_options : List Demographic Answer Options

Departments

GET https://harvest.greenhouse.io/v1/departments : List Organization's Departments
PATCH https://harvest.greenhouse.io/v1/departments/{id} : Edit Department's Basic Information

Disciplines

GET https://harvest.greenhouse.io/v1/disciplines : List Organization's Disciplines

EEOC

GET https://harvest.greenhouse.io/v1/eeoc : List Organization's EEOC Data

Email Templates

GET https://harvest.greenhouse.io/v1/email_templates : List Organization's Email Templates
GET https://harvest.greenhouse.io/v1/email_templates/{id} : Retrieve Email Template by ID

Job Posts

GET https://harvest.greenhouse.io/v1/job_posts : List Organization's Job Posts
GET https://harvest.greenhouse.io/v1/job_posts/{id} : Get Single Job Post
GET https://harvest.greenhouse.io/v1/job_posts/{id}/custom_locations : List Custom Location Options for Job Post

Job Stages

GET https://harvest.greenhouse.io/v1/job_stages : List Organization's Job Stages
GET https://harvest.greenhouse.io/v1/job_stages/{id} : Retrieve Job Stage by ID

Jobs

GET https://harvest.greenhouse.io/v1/jobs : List Organization's Jobs
PATCH https://harvest.greenhouse.io/v1/jobs/{id} : Update Job Details
GET https://harvest.greenhouse.io/v1/jobs/{id}/approval_flows : List all of a job’s approval flows
GET https://harvest.greenhouse.io/v1/jobs/{id}/hiring_team : Get Hiring Team for a Job
GET https://harvest.greenhouse.io/v1/jobs/{id}/job_post : Retrieve Job Post by Job ID
GET https://harvest.greenhouse.io/v1/jobs/{id}/job_posts : List Job Posts for a Given Job ID
GET https://harvest.greenhouse.io/v1/jobs/{id}/stages : Retrieve Job Stages by Job ID
PUT https://harvest.greenhouse.io/v1/jobs/{job_id}/approval_flows : Create or Replace Approval Flow for a Job or Offer
POST https://harvest.greenhouse.io/v1/jobs/{job_id}/openings : Create Job Openings in Greenhouse
PATCH https://harvest.greenhouse.io/v1/jobs/{job_id}/openings/{id} : Update Job Opening Details

Offers

GET https://harvest.greenhouse.io/v1/offers : Get All Offers Made by an Organization
GET https://harvest.greenhouse.io/v1/offers/{id} : Retrieve Offer by ID

Offices

POST https://harvest.greenhouse.io/v1/offices : Create a New Office
PATCH https://harvest.greenhouse.io/v1/offices/{id} : Edit Office Basic Information

Prospect Pools

GET https://harvest.greenhouse.io/v1/prospect_pools : List Organization's Prospect Pools
GET https://harvest.greenhouse.io/v1/prospect_pools/{id} : Retrieve Prospect Pool

Prospects

POST https://harvest.greenhouse.io/v1/prospects : Create a New Prospect in Greenhouse

Rejection Reasons

GET https://harvest.greenhouse.io/v1/rejection_reasons : List Organization's Rejection Reasons

Scheduled Interviews

GET https://harvest.greenhouse.io/v1/scheduled_interviews : List Scheduled Interviews for an Organization
DELETE https://harvest.greenhouse.io/v1/scheduled_interviews/{id} : Delete a Scheduled Interview by ID
POST https://harvest.greenhouse.io/v2/scheduled_interviews : Create a New Scheduled Interview
PATCH https://harvest.greenhouse.io/v2/scheduled_interviews/{id} : Update a Scheduled Interview

Schools

GET https://harvest.greenhouse.io/v1/schools : List Organization's Schools

Scorecards

GET https://harvest.greenhouse.io/v1/scorecards : List Organization's Scorecards
GET https://harvest.greenhouse.io/v1/scorecards/{id} : Retrieve Scorecard

Sources

GET https://harvest.greenhouse.io/v1/sources : List Organization's Sources Grouped by Strategy

Tracking Links

GET https://harvest.greenhouse.io/v1/tracking_links/{token} : Retrieve Tracking Link Data

User Roles

GET https://harvest.greenhouse.io/v1/user_roles : List Organization's Roles for User Assignment

Users

POST https://harvest.greenhouse.io/v1/users : Create a New User with Basic Permissions
PATCH https://harvest.greenhouse.io/v1/users/permission_level : Change User Permission Level to Basic
GET https://harvest.greenhouse.io/v1/users/{id} : Retrieve User Details
POST https://harvest.greenhouse.io/v1/users/{id}/email_addresses : Create Unverified Email Address for User
DELETE https://harvest.greenhouse.io/v1/users/{id}/permissions/future_jobs : Delete User's Future Job Permission
POST https://harvest.greenhouse.io/v1/users/{id}/permissions/jobs : Create Job Permission for User
GET https://harvest.greenhouse.io/v1/users/{user_id}/pending_approvals : Get Pending Approvals for User
PATCH https://harvest.greenhouse.io/v2/users/ : Edit User's Basic Information
PATCH https://harvest.greenhouse.io/v2/users/disable : Disable a User
PATCH https://harvest.greenhouse.io/v2/users/enable : Enable a User in Greenhouse

Job Posts (v2)

PATCH https://harvest.greenhouse.io/v2/job_posts/{id} : Update Job Post Properties
PATCH https://harvest.greenhouse.io/v2/job_posts/{id}/status : Update Job Post Status

Jobs (v2)

DELETE https://harvest.greenhouse.io/v2/jobs/{job_id}/openings : Delete Job Openings

‍

Greenhouse API FAQs

How do I generate an API key in Greenhouse?

Answer: To generate an API key in Greenhouse:some text
1. Click the Configure icon on your navigation bar.
2. Navigate to Dev Center > API Credential Management.
3. Click Create New API Key.
4. Select the API type (e.g., Harvest) and provide a description.
5. Click Create and copy the generated API key to a secure location.
Source: Create a Harvest API key for an integration – Greenhouse Support

What authentication method does the Greenhouse API use?

Answer: The Greenhouse API uses HTTP Basic Authentication. The API key serves as the username, and the password should be left blank. Include the 'Authorization' header in your HTTP requests, formatted as 'Basic {Base64EncodedAPIKey:}'.
Source: Harvest API | Greenhouse - Greenhouse Software

Are there rate limits for the Greenhouse API?

Answer: Yes, Greenhouse enforces rate limits to ensure fair usage:some text
- Harvest API: 50 requests per 10 seconds.
- Exceeding the limit will return an HTTP 429 response.
Source: Harvest API | Greenhouse - Greenhouse Software

Can I retrieve candidate information using the Greenhouse API?

Answer: Yes, you can retrieve candidate information using the Harvest API. For example, to list all candidates, make a GET request to the /v1/candidates/ endpoint.
Source: Harvest API | Greenhouse - Greenhouse Software

Does the Greenhouse API support webhooks?

Answer: Yes, Greenhouse supports webhooks, allowing you to receive real-time notifications for specific events, such as candidate application submissions or status changes.
Source: Developer Resources | Greenhouse

‍

Get Started with Greenhouse API Integration

For quick and seamless integration with Greenhouse API, Knit API offers a convenient solution. It’s AI powered integration platform allows you to build any Greenhouse API Integration use case. By integrating with Knit just once, you can integrate with multiple other CRMs, HRIS, Accounting, and other systems in one go with a unified approach. Knit takes care of all the authentication, authorization, and ongoing integration maintenance. This approach not only saves time but also ensures a smooth and reliable connection to Greenhouse API.‍

To sign up for free, click here. To check the pricing, see our pricing page.

‍