AptlyStar

Greenhouse

Manage candidates, jobs, and applications in Greenhouse

使用方法

Integrate Greenhouse into the workflow. List and retrieve candidates, jobs, applications, users, departments, offices, and job stages from your Greenhouse ATS account.

ツール

greenhouse_list_candidates

Lists candidates from Greenhouse with optional filtering by date, job, or email

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination
created_afterstringいいえReturn only candidates created at or after this ISO 8601 timestamp
created_beforestringいいえReturn only candidates created before this ISO 8601 timestamp
updated_afterstringいいえReturn only candidates updated at or after this ISO 8601 timestamp
updated_beforestringいいえReturn only candidates updated before this ISO 8601 timestamp
job_idstringいいえFilter to candidates who applied to this job ID (excludes prospects)
emailstringいいえFilter to candidates with this email address
candidate_idsstringいいえComma-separated candidate IDs to retrieve (max 50)

出力

パラメータ型説明
candidatesarrayList of candidates
↳ idnumberCandidate ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ companystringCurrent employer
↳ titlestringCurrent job title
↳ is_privatebooleanWhether candidate is private
↳ can_emailbooleanWhether candidate can be emailed
↳ email_addressesarrayEmail addresses
↳ valuestringEmail address
↳ typestringEmail type (personal, work, other)
↳ tagsarrayCandidate tags
↳ application_idsarrayAssociated application IDs
↳ created_atstringCreation timestamp (ISO 8601)
↳ updated_atstringLast updated timestamp (ISO 8601)
↳ last_activitystringLast activity timestamp (ISO 8601)
countnumberNumber of candidates returned

greenhouse_get_candidate

Retrieves a specific candidate by ID with full details including contact info, education, and employment history

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
candidateIdstringはいThe ID of the candidate to retrieve

出力

パラメータ型説明
idnumberCandidate ID
first_namestringFirst name
last_namestringLast name
companystringCurrent employer
titlestringCurrent job title
is_privatebooleanWhether candidate is private
can_emailbooleanWhether candidate can be emailed
created_atstringCreation timestamp (ISO 8601)
updated_atstringLast updated timestamp (ISO 8601)
last_activitystringLast activity timestamp (ISO 8601)
email_addressesarrayEmail addresses
↳ valuestringEmail address
↳ typestringType (personal, work, other)
phone_numbersarrayPhone numbers
↳ valuestringPhone number
↳ typestringType (home, work, mobile, skype, other)
addressesarrayAddresses
↳ valuestringAddress
↳ typestringType (home, work, other)
website_addressesarrayWebsite addresses
↳ valuestringURL
↳ typestringType (personal, company, portfolio, blog, other)
social_media_addressesarraySocial media profiles
↳ valuestringURL or handle
tagsarrayTags
application_idsarrayAssociated application IDs
recruiterobjectAssigned recruiter
↳ idnumberUser ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ namestringFull name
↳ employee_idstringEmployee ID
coordinatorobjectAssigned coordinator
↳ idnumberUser ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ namestringFull name
↳ employee_idstringEmployee ID
attachmentsarrayFile attachments (URLs expire after 7 days)
↳ filenamestringFile name
↳ urlstringDownload URL (expires after 7 days)
↳ typestringType (resume, cover_letter, offer_packet, other)
↳ created_atstringUpload timestamp
educationsarrayEducation history
↳ idnumberEducation record ID
↳ school_namestringSchool name
↳ degreestringDegree type
↳ disciplinestringField of study
↳ start_datestringStart date (ISO 8601)
↳ end_datestringEnd date (ISO 8601)
employmentsarrayEmployment history
↳ idnumberEmployment record ID
↳ company_namestringCompany name
↳ titlestringJob title
↳ start_datestringStart date (ISO 8601)
↳ end_datestringEnd date (ISO 8601)
custom_fieldsobjectCustom field values

greenhouse_list_jobs

Lists jobs from Greenhouse with optional filtering by status, department, or office

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination
statusstringいいえFilter by job status (open, closed, draft)
created_afterstringいいえReturn only jobs created at or after this ISO 8601 timestamp
created_beforestringいいえReturn only jobs created before this ISO 8601 timestamp
updated_afterstringいいえReturn only jobs updated at or after this ISO 8601 timestamp
updated_beforestringいいえReturn only jobs updated before this ISO 8601 timestamp
department_idstringいいえFilter to jobs in this department ID
office_idstringいいえFilter to jobs in this office ID

出力

パラメータ型説明
jobsarrayList of jobs
↳ idnumberJob ID
↳ namestringJob title
↳ statusstringJob status (open, closed, draft)
↳ confidentialbooleanWhether the job is confidential
↳ departmentsarrayAssociated departments
↳ idnumberDepartment ID
↳ namestringDepartment name
↳ officesarrayAssociated offices
↳ idnumberOffice ID
↳ namestringOffice name
↳ opened_atstringDate job was opened (ISO 8601)
↳ closed_atstringDate job was closed (ISO 8601)
↳ created_atstringCreation timestamp (ISO 8601)
↳ updated_atstringLast updated timestamp (ISO 8601)
countnumberNumber of jobs returned

greenhouse_get_job

Retrieves a specific job by ID with full details including hiring team, openings, and custom fields

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
jobIdstringはいThe ID of the job to retrieve

出力

パラメータ型説明
idnumberJob ID
namestringJob title
requisition_idstringExternal requisition ID
statusstringJob status (open, closed, draft)
confidentialbooleanWhether the job is confidential
created_atstringCreation timestamp (ISO 8601)
opened_atstringDate job was opened (ISO 8601)
closed_atstringDate job was closed (ISO 8601)
updated_atstringLast updated timestamp (ISO 8601)
is_templatebooleanWhether this is a job template
notesstringHiring plan notes (may contain HTML)
departmentsarrayAssociated departments
↳ idnumberDepartment ID
↳ namestringDepartment name
↳ parent_idnumberParent department ID
officesarrayAssociated offices
↳ idnumberOffice ID
↳ namestringOffice name
↳ locationobjectOffice location
↳ namestringLocation name
hiring_teamobjectHiring team members
↳ hiring_managersarrayHiring managers
↳ recruitersarrayRecruiters (includes responsible flag)
↳ coordinatorsarrayCoordinators (includes responsible flag)
↳ sourcersarraySourcers
openingsarrayJob openings/slots
↳ idnumberOpening internal ID
↳ opening_idstringCustom opening identifier
↳ statusstringOpening status (open, closed)
↳ opened_atstringDate opened (ISO 8601)
↳ closed_atstringDate closed (ISO 8601)
↳ application_idnumberHired application ID
↳ close_reasonobjectReason for closing
↳ idnumberClose reason ID
↳ namestringClose reason name
custom_fieldsobjectCustom field values

greenhouse_list_applications

Lists applications from Greenhouse with optional filtering by job, status, or date

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination
job_idstringいいえFilter applications by job ID
statusstringいいえFilter by status (active, converted, hired, rejected)
created_afterstringいいえReturn only applications created at or after this ISO 8601 timestamp
created_beforestringいいえReturn only applications created before this ISO 8601 timestamp
last_activity_afterstringいいえReturn only applications with activity at or after this ISO 8601 timestamp

出力

パラメータ型説明
applicationsarrayList of applications
↳ idnumberApplication ID
↳ candidate_idnumberAssociated candidate ID
↳ prospectbooleanWhether this is a prospect application
↳ statusstringStatus (active, converted, hired, rejected)
↳ current_stageobjectCurrent interview stage
↳ idnumberStage ID
↳ namestringStage name
↳ jobsarrayAssociated jobs
↳ idnumberJob ID
↳ namestringJob name
↳ applied_atstringApplication date (ISO 8601)
↳ rejected_atstringRejection date (ISO 8601)
↳ last_activity_atstringLast activity date (ISO 8601)
countnumberNumber of applications returned

greenhouse_get_application

Retrieves a specific application by ID with full details including source, stage, answers, and attachments

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
applicationIdstringはいThe ID of the application to retrieve

出力

パラメータ型説明
idnumberApplication ID
candidate_idnumberAssociated candidate ID
prospectbooleanWhether this is a prospect application
statusstringStatus (active, converted, hired, rejected)
applied_atstringApplication date (ISO 8601)
rejected_atstringRejection date (ISO 8601)
last_activity_atstringLast activity date (ISO 8601)
locationobjectCandidate location
↳ addressstringLocation address
sourceobjectApplication source
↳ idnumberSource ID
↳ public_namestringSource name
credited_toobjectUser credited for the application
↳ idnumberUser ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ namestringFull name
↳ employee_idstringEmployee ID
recruiterobjectAssigned recruiter
↳ idnumberUser ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ namestringFull name
↳ employee_idstringEmployee ID
coordinatorobjectAssigned coordinator
↳ idnumberUser ID
↳ first_namestringFirst name
↳ last_namestringLast name
↳ namestringFull name
↳ employee_idstringEmployee ID
current_stageobjectCurrent interview stage (null when hired)
↳ idnumberStage ID
↳ namestringStage name
rejection_reasonobjectRejection reason
↳ idnumberRejection reason ID
↳ namestringRejection reason name
↳ typeobjectRejection reason type
↳ idnumberType ID
↳ namestringType name
jobsarrayAssociated jobs
↳ idnumberJob ID
↳ namestringJob name
job_post_idnumberJob post ID
answersarrayApplication question answers
↳ questionstringQuestion text
↳ answerstringAnswer text
attachmentsarrayFile attachments (URLs expire after 7 days)
↳ filenamestringFile name
↳ urlstringDownload URL (expires after 7 days)
↳ typestringType (resume, cover_letter, offer_packet, other)
↳ created_atstringUpload timestamp
custom_fieldsobjectCustom field values

greenhouse_list_users

Lists Greenhouse users (recruiters, hiring managers, admins) with optional filtering

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination
created_afterstringいいえReturn only users created at or after this ISO 8601 timestamp
created_beforestringいいえReturn only users created before this ISO 8601 timestamp
updated_afterstringいいえReturn only users updated at or after this ISO 8601 timestamp
updated_beforestringいいえReturn only users updated before this ISO 8601 timestamp
emailstringいいえFilter by email address

出力

パラメータ型説明
usersarrayList of Greenhouse users
↳ idnumberUser ID
↳ namestringFull name
↳ first_namestringFirst name
↳ last_namestringLast name
↳ primary_email_addressstringPrimary email
↳ disabledbooleanWhether the user is disabled
↳ site_adminbooleanWhether the user is a site admin
↳ emailsarrayAll email addresses
↳ employee_idstringEmployee ID
↳ linked_candidate_idsarrayIDs of candidates linked to this user
↳ created_atstringCreation timestamp (ISO 8601)
↳ updated_atstringLast updated timestamp (ISO 8601)
countnumberNumber of users returned

greenhouse_get_user

Retrieves a specific Greenhouse user by ID

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
userIdstringはいThe ID of the user to retrieve

出力

パラメータ型説明
idnumberUser ID
namestringFull name
first_namestringFirst name
last_namestringLast name
primary_email_addressstringPrimary email address
disabledbooleanWhether the user is disabled
site_adminbooleanWhether the user is a site admin
emailsarrayAll email addresses
employee_idstringEmployee ID
linked_candidate_idsarrayIDs of candidates linked to this user
created_atstringCreation timestamp (ISO 8601)
updated_atstringLast updated timestamp (ISO 8601)

greenhouse_list_departments

Lists all departments configured in Greenhouse

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination

出力

パラメータ型説明
departmentsarrayList of departments
↳ idnumberDepartment ID
↳ namestringDepartment name
↳ parent_idnumberParent department ID
↳ child_idsarrayChild department IDs
↳ external_idstringExternal system ID
countnumberNumber of departments returned

greenhouse_list_offices

Lists all offices configured in Greenhouse

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination

出力

パラメータ型説明
officesarrayList of offices
↳ idnumberOffice ID
↳ namestringOffice name
↳ locationobjectOffice location
↳ namestringLocation name
↳ primary_contact_user_idnumberPrimary contact user ID
↳ parent_idnumberParent office ID
↳ child_idsarrayChild office IDs
↳ external_idstringExternal system ID
countnumberNumber of offices returned

greenhouse_list_job_stages

Lists all interview stages for a specific job in Greenhouse

入力

パラメータ型必須説明
apiKeystringはいGreenhouse Harvest API key
jobIdstringはいThe job ID to list stages for
per_pagenumberいいえNumber of results per page (1-500, default 100)
pagenumberいいえPage number for pagination

出力

パラメータ型説明
stagesarrayList of job stages in order
↳ idnumberStage ID
↳ namestringStage name
↳ created_atstringCreation timestamp (ISO 8601)
↳ updated_atstringLast updated timestamp (ISO 8601)
↳ job_idnumberAssociated job ID
↳ prioritynumberStage order priority
↳ activebooleanWhether the stage is active
↳ interviewsarrayInterview steps in this stage
↳ idnumberInterview ID
↳ namestringInterview name
↳ schedulablebooleanWhether the interview is schedulable
↳ estimated_minutesnumberEstimated duration in minutes
↳ default_interviewer_usersarrayDefault interviewers
↳ idnumberUser ID
↳ namestringFull name
↳ first_namestringFirst name
↳ last_namestringLast name
↳ employee_idstringEmployee ID
↳ interview_kitobjectInterview kit details
↳ idnumberKit ID
↳ contentstringKit content (HTML)
↳ questionsarrayInterview kit questions
↳ idnumberQuestion ID
↳ questionstringQuestion text
countnumberNumber of stages returned

On this page