Logo
Greenhouse Logo

Greenhouse APIs

Greenhouse helps thousands of companies design and automate all aspects of hiring throughout their organizations, helping them compete for and win top talent with the Greenhouse Talent Acquisition suite.

Developer

Greenhouse APIs

Account Request URL

https://developers.greenhouse.io/harvest.html

Base Endpoint

https://harvest.greenhouse.io/v1/

Candidate

Retrieve a **single** candidate by their ID.

/v1/candidates/:candidate_id

candidate_id

Candidate

Create a new candidate.

/v1/candidates

first_name, last_name, email, [external_id], [source], [source_id], [custom_fields]

Candidate

Update a candidate by their ID.

/v1/candidates/:candidate_id

candidate_id, [first_name], [last_name], [email], [external_id], [source], [source_id], [custom_fields]

Candidate

Delete a candidate by their ID. This will also delete the candidate's resume and all associated notes.

/v1/candidates/:candidate_id

candidate_id

Candidate

Retrieve a list of all candidates. Candidates can be filtered by a variety of criteria.

/v1/candidates

updated_at_min, updated_at_max, recruiter_id, job_id, team_id, status, source, query

Candidate

Permanently delete a candidate by their ID. This will also delete the candidate's resume and all associated notes.

/v1/candidates/:candidate_id/purge

candidate_id

Job

Retrieve a **single** job by its ID.

/v1/jobs/:job_id

job_id

Job

Create a new job.

/v1/jobs

title, content, [job_board_postings], [external_id], [location], [source], [source_id], [custom_fields]

Job

Update a job by its ID.

/v1/jobs/:job_id

job_id, [title], [content], [job_board_postings], [external_id], [location], [source], [source_id], [custom_fields]

Job

Delete a job by its ID.

/v1/jobs/:job_id

job_id

Job

Retrieve a list of all jobs. Jobs can be filtered by a variety of criteria.

/v1/jobs

updated_at_min, updated_at_max, recruiter_id, team_id, title, content, location, stage, status, query

Job

Permanently delete a job by its ID.

/v1/jobs/:job_id/purge

job_id

Team

Retrieve a **single** team by its ID.

/v1/teams/:team_id

team_id

Team

Retrieve a list of all teams.

/v1/teams

updated_at_min, updated_at_max, recruiter_id, query

Recruiter

Retrieve a **single** recruiter by their ID.

/v1/recruiters/:recruiter_id

recruiter_id

Recruiter

Retrieve a list of all recruiters.

/v1/recruiters

updated_at_min, updated_at_max, query

Note

Retrieve a **single** note by its ID.

/v1/notes/:note_id

note_id

Note

Create a new note.

/v1/notes

[owner_type], [owner_id], body, [pinned], [permalinks]

Note

Update a note by its ID.

/v1/notes/:note_id

note_id, [body], [pinned], [permalinks]

Note

Delete a note by its ID.

/v1/notes/:note_id

note_id

Note

Retrieve a list of all notes.

/v1/notes

updated_at_min, updated_at_max, owner_type, owner_id, query

Details

Provider

Country HQ

US

API Type

REST

Categories

ATS

Alternatives

Important URLs

Last Updated on

2024-04-03

Created At

2024-03-04

Other Apps

Upskill for a better future

Want to start tracking API at scale?

Get updates about your favorite APIs and SDKs

Contact Us

We do our best to ensure that the data we release is complete, accurate, and useful. However, because we are not able to verify all the data, and because the processing required to make the data useful is complex, we cannot be held liable for omissions or inaccuracies.

ApiRefs Logo