Greenhouse Harvest API MCP Server for Cloudflare Workers
107 tools available in the Greenhouse MCP server. Each tool can be called by AI assistants to perform specific actions.
greenhouse_advance_applicationAdvance an application to the next stage
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"fromStageId": {
"type": "number",
"description": "Current stage ID (for verification)"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_delete_candidateDelete a candidate
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_get_scheduled_interviewGet a specific scheduled interview
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "number",
"description": "The scheduled interview ID"
}
}
}greenhouse_list_job_postsList all job posts
{
"type": "object",
"properties": {
"live": {
"type": "boolean",
"description": "Filter by live status"
},
"page": {
"type": "number",
"description": "Page number"
},
"jobId": {
"type": "number",
"description": "Filter by job ID"
},
"active": {
"type": "boolean",
"description": "Filter by active status"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
}
}
}greenhouse_remove_hiring_team_memberRemove a member from a job hiring team
{
"type": "object",
"required": [
"jobId",
"userId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
},
"userId": {
"type": "number",
"description": "The user ID to remove"
}
}
}greenhouse_get_job_postGet a specific job post
{
"type": "object",
"required": [
"jobPostId"
],
"properties": {
"jobPostId": {
"type": "number",
"description": "The job post ID"
}
}
}greenhouse_add_application_attachmentAdd an attachment to an application
{
"type": "object",
"required": [
"applicationId",
"filename"
],
"properties": {
"url": {
"type": "string",
"description": "URL to the file"
},
"content": {
"type": "string",
"description": "Base64-encoded file content"
},
"filename": {
"type": "string",
"description": "Filename"
},
"contentType": {
"type": "string",
"description": "MIME type of the content"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_list_applicationsList all applications in Greenhouse with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"jobId": {
"type": "number",
"description": "Filter by job ID"
},
"status": {
"enum": [
"active",
"rejected",
"hired"
],
"type": "string",
"description": "Filter by status"
},
"perPage": {
"type": "number",
"description": "Number of results per page (max 500)"
},
"candidateId": {
"type": "number",
"description": "Filter by candidate ID"
},
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"createdBefore": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"lastActivityAfter": {
"type": "string",
"description": "Filter by last activity date (ISO 8601)"
}
}
}greenhouse_get_applicationGet a specific application by ID
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_create_applicationCreate a new application for an existing candidate
{
"type": "object",
"required": [
"candidateId",
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID to apply for"
},
"sourceId": {
"type": "number",
"description": "Source ID"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"initialStageId": {
"type": "number",
"description": "Initial stage ID"
},
"prospectPoolId": {
"type": "number",
"description": "Prospect pool ID (for prospects)"
},
"prospectOwnerId": {
"type": "number",
"description": "Prospect owner user ID"
},
"prospectStageId": {
"type": "number",
"description": "Prospect stage ID"
}
}
}greenhouse_update_applicationUpdate an existing application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"sourceId": {
"type": "number",
"description": "Source ID"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_delete_applicationDelete an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_move_applicationMove an application to a specific stage within the same job
{
"type": "object",
"required": [
"applicationId",
"fromStageId",
"toStageId"
],
"properties": {
"toStageId": {
"type": "number",
"description": "Target stage ID"
},
"fromStageId": {
"type": "number",
"description": "Current stage ID"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_transfer_applicationTransfer an application to a different job
{
"type": "object",
"required": [
"applicationId",
"newJobId"
],
"properties": {
"newJobId": {
"type": "number",
"description": "Target job ID"
},
"newStageId": {
"type": "number",
"description": "Target stage ID in new job"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_reject_applicationReject an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"notes": {
"type": "string",
"description": "Internal notes"
},
"sendEmail": {
"type": "boolean",
"description": "Whether to send rejection email"
},
"applicationId": {
"type": "number",
"description": "The application ID"
},
"rejectionReasonId": {
"type": "number",
"description": "Rejection reason ID"
},
"rejectionEmailTemplateId": {
"type": "number",
"description": "Email template ID for notification"
}
}
}greenhouse_unreject_applicationUnreject a previously rejected application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_hire_applicationMark an application as hired
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"openingId": {
"type": "number",
"description": "Opening ID to fill"
},
"startDate": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"applicationId": {
"type": "number",
"description": "The application ID"
},
"closeReasonId": {
"type": "number",
"description": "Close reason ID"
}
}
}greenhouse_convert_prospectConvert a prospect to a candidate application
{
"type": "object",
"required": [
"applicationId",
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID to convert to"
},
"applicationId": {
"type": "number",
"description": "The prospect application ID"
}
}
}greenhouse_list_eeoc_dataList EEOC data for applications
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
},
"submittedAfter": {
"type": "string",
"description": "Filter by submission date (ISO 8601)"
},
"submittedBefore": {
"type": "string",
"description": "Filter by submission date (ISO 8601)"
}
}
}greenhouse_get_application_eeocGet EEOC data for a specific application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_list_demographic_question_setsList all demographic question sets
{
"type": "object",
"properties": {}
}greenhouse_get_demographic_question_setGet a specific demographic question set
{
"type": "object",
"required": [
"setId"
],
"properties": {
"setId": {
"type": "number",
"description": "The question set ID"
}
}
}greenhouse_list_demographic_questionsList demographic questions
{
"type": "object",
"properties": {
"demographicQuestionSetId": {
"type": "number",
"description": "Filter by question set ID"
}
}
}greenhouse_list_demographic_answersList demographic answers
{
"type": "object",
"properties": {
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"applicationId": {
"type": "number",
"description": "Filter by application ID"
},
"createdBefore": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
}
}
}greenhouse_list_candidatesList all candidates in Greenhouse with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"email": {
"type": "string",
"description": "Filter by email address"
},
"jobId": {
"type": "number",
"description": "Filter by job ID"
},
"perPage": {
"type": "number",
"description": "Number of results per page (max 500)"
},
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"updatedAfter": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
},
"createdBefore": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"updatedBefore": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
}
}
}greenhouse_get_candidateGet a specific candidate by ID
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_create_candidateCreate a new candidate in Greenhouse
{
"type": "object",
"required": [
"firstName",
"lastName"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags to add"
},
"title": {
"type": "string",
"description": "Current title"
},
"company": {
"type": "string",
"description": "Current company"
},
"lastName": {
"type": "string",
"description": "Last name"
},
"firstName": {
"type": "string",
"description": "First name"
},
"isPrivate": {
"type": "boolean",
"description": "Whether candidate is private"
},
"recruiterEmail": {
"type": "string",
"description": "Recruiter email"
},
"coordinatorEmail": {
"type": "string",
"description": "Coordinator email"
}
}
}greenhouse_update_candidateUpdate an existing candidate
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags"
},
"title": {
"type": "string",
"description": "Current title"
},
"company": {
"type": "string",
"description": "Current company"
},
"lastName": {
"type": "string",
"description": "Last name"
},
"firstName": {
"type": "string",
"description": "First name"
},
"isPrivate": {
"type": "boolean",
"description": "Whether candidate is private"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_add_candidate_noteAdd a note to a candidate
{
"type": "object",
"required": [
"candidateId",
"userId",
"body",
"visibility"
],
"properties": {
"body": {
"type": "string",
"description": "Note content"
},
"userId": {
"type": "number",
"description": "User ID creating the note"
},
"visibility": {
"enum": [
"admin_only",
"private",
"public"
],
"type": "string",
"description": "Note visibility"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_add_candidate_emailAdd an email to a candidate record
{
"type": "object",
"required": [
"candidateId",
"userId",
"to",
"from",
"subject",
"body"
],
"properties": {
"cc": {
"type": "array",
"items": {
"type": "string"
},
"description": "CC recipients"
},
"to": {
"type": "string",
"description": "Recipient email"
},
"body": {
"type": "string",
"description": "Email body"
},
"from": {
"type": "string",
"description": "Sender email"
},
"userId": {
"type": "number",
"description": "User ID logging the email"
},
"subject": {
"type": "string",
"description": "Email subject"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_add_candidate_attachmentAdd an attachment to a candidate
{
"type": "object",
"required": [
"candidateId",
"filename"
],
"properties": {
"url": {
"type": "string",
"description": "URL to the file"
},
"content": {
"type": "string",
"description": "Base64-encoded file content"
},
"filename": {
"type": "string",
"description": "Filename"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"contentType": {
"type": "string",
"description": "MIME type of the content"
}
}
}greenhouse_get_candidate_activity_feedGet the activity feed for a candidate
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_anonymize_candidateAnonymize a candidate (GDPR compliance)
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_merge_candidatesMerge two candidate records
{
"type": "object",
"required": [
"primaryCandidateId",
"duplicateCandidateId"
],
"properties": {
"primaryCandidateId": {
"type": "number",
"description": "Primary candidate ID (kept)"
},
"duplicateCandidateId": {
"type": "number",
"description": "Duplicate candidate ID (merged into primary)"
}
}
}greenhouse_add_candidate_educationAdd education to a candidate
{
"type": "object",
"required": [
"candidateId"
],
"properties": {
"degree": {
"type": "string",
"description": "Degree name (if not using ID)"
},
"endDate": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
},
"degreeId": {
"type": "number",
"description": "Degree ID from reference data"
},
"schoolId": {
"type": "number",
"description": "School ID from reference data"
},
"startDate": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"discipline": {
"type": "string",
"description": "Discipline name (if not using ID)"
},
"schoolName": {
"type": "string",
"description": "School name (if not using ID)"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"disciplineId": {
"type": "number",
"description": "Discipline ID from reference data"
}
}
}greenhouse_delete_candidate_educationRemove education from a candidate
{
"type": "object",
"required": [
"candidateId",
"educationId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"educationId": {
"type": "number",
"description": "The education record ID"
}
}
}greenhouse_add_candidate_employmentAdd employment history to a candidate
{
"type": "object",
"required": [
"candidateId",
"companyName"
],
"properties": {
"title": {
"type": "string",
"description": "Job title"
},
"endDate": {
"type": "string",
"description": "End date (YYYY-MM-DD)"
},
"startDate": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"companyName": {
"type": "string",
"description": "Company name"
}
}
}greenhouse_delete_candidate_employmentRemove employment from a candidate
{
"type": "object",
"required": [
"candidateId",
"employmentId"
],
"properties": {
"candidateId": {
"type": "number",
"description": "The candidate ID"
},
"employmentId": {
"type": "number",
"description": "The employment record ID"
}
}
}greenhouse_list_candidate_tagsList all candidate tags
{
"type": "object",
"properties": {}
}greenhouse_create_candidate_tagCreate a new candidate tag
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Tag name"
}
}
}greenhouse_delete_candidate_tagDelete a candidate tag
{
"type": "object",
"required": [
"tagId"
],
"properties": {
"tagId": {
"type": "number",
"description": "The tag ID"
}
}
}greenhouse_add_tag_to_candidateAdd a tag to a candidate
{
"type": "object",
"required": [
"candidateId",
"tagId"
],
"properties": {
"tagId": {
"type": "number",
"description": "The tag ID"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_remove_tag_from_candidateRemove a tag from a candidate
{
"type": "object",
"required": [
"candidateId",
"tagId"
],
"properties": {
"tagId": {
"type": "number",
"description": "The tag ID"
},
"candidateId": {
"type": "number",
"description": "The candidate ID"
}
}
}greenhouse_list_scheduled_interviewsList scheduled interviews with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
},
"interviewId": {
"type": "number",
"description": "Filter by interview type ID"
},
"startsAfter": {
"type": "string",
"description": "Filter by start time (ISO 8601)"
},
"startsBefore": {
"type": "string",
"description": "Filter by start time (ISO 8601)"
},
"updatedAfter": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
},
"applicationId": {
"type": "number",
"description": "Filter by application ID"
},
"updatedBefore": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
}
}
}greenhouse_update_job_openingUpdate a job opening
{
"type": "object",
"required": [
"openingId"
],
"properties": {
"status": {
"enum": [
"open",
"closed"
],
"type": "string",
"description": "Opening status"
},
"openingId": {
"type": "number",
"description": "The opening ID"
},
"closeReasonId": {
"type": "number",
"description": "Close reason ID"
},
"targetStartDate": {
"type": "string",
"description": "Target start date (YYYY-MM-DD)"
}
}
}greenhouse_create_scheduled_interviewSchedule a new interview
{
"type": "object",
"required": [
"applicationId",
"interviewId",
"interviewerIds",
"start",
"end"
],
"properties": {
"end": {
"type": "string",
"description": "End time (ISO 8601)"
},
"start": {
"type": "string",
"description": "Start time (ISO 8601)"
},
"location": {
"type": "string",
"description": "Interview location"
},
"interviewId": {
"type": "number",
"description": "The interview type ID"
},
"organizerId": {
"type": "number",
"description": "Organizer user ID"
},
"applicationId": {
"type": "number",
"description": "The application ID"
},
"interviewerIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "User IDs of interviewers"
},
"externalEventId": {
"type": "string",
"description": "External calendar event ID"
},
"sendNotifications": {
"type": "boolean",
"description": "Send calendar notifications"
}
}
}greenhouse_update_scheduled_interviewUpdate a scheduled interview
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"end": {
"type": "string",
"description": "End time (ISO 8601)"
},
"start": {
"type": "string",
"description": "Start time (ISO 8601)"
},
"location": {
"type": "string",
"description": "Interview location"
},
"interviewId": {
"type": "number",
"description": "The scheduled interview ID"
},
"interviewerIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "User IDs of interviewers"
},
"externalEventId": {
"type": "string",
"description": "External calendar event ID"
},
"sendNotifications": {
"type": "boolean",
"description": "Send calendar notifications"
}
}
}greenhouse_delete_scheduled_interviewDelete a scheduled interview
{
"type": "object",
"required": [
"interviewId"
],
"properties": {
"interviewId": {
"type": "number",
"description": "The scheduled interview ID"
}
}
}greenhouse_list_scorecardsList scorecards with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
},
"interviewId": {
"type": "number",
"description": "Filter by interview type ID"
},
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"updatedAfter": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
},
"applicationId": {
"type": "number",
"description": "Filter by application ID"
},
"interviewerId": {
"type": "number",
"description": "Filter by interviewer user ID"
}
}
}greenhouse_get_scorecardGet a specific scorecard
{
"type": "object",
"required": [
"scorecardId"
],
"properties": {
"scorecardId": {
"type": "number",
"description": "The scorecard ID"
}
}
}greenhouse_list_application_scorecardsList all scorecards for an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_list_jobsList all jobs in Greenhouse with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"status": {
"enum": [
"open",
"closed",
"draft"
],
"type": "string",
"description": "Filter by job status"
},
"perPage": {
"type": "number",
"description": "Number of results per page (max 500)"
},
"officeId": {
"type": "number",
"description": "Filter by office ID"
},
"departmentId": {
"type": "number",
"description": "Filter by department ID"
}
}
}greenhouse_get_jobGet a specific job by ID
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
}
}
}greenhouse_create_jobCreate a new job in Greenhouse
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Job title"
},
"notes": {
"type": "string",
"description": "Internal notes"
},
"officeIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Office IDs"
},
"departmentId": {
"type": "number",
"description": "Department ID"
},
"requisitionId": {
"type": "string",
"description": "Requisition ID"
},
"templateJobId": {
"type": "number",
"description": "Template job ID to copy from"
},
"numberOfOpenings": {
"type": "number",
"description": "Number of openings"
}
}
}greenhouse_update_jobUpdate an existing job
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"name": {
"type": "string",
"description": "Job title"
},
"jobId": {
"type": "number",
"description": "The job ID"
},
"notes": {
"type": "string",
"description": "Internal notes"
},
"status": {
"enum": [
"open",
"closed"
],
"type": "string",
"description": "Job status"
},
"officeIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Office IDs"
},
"departmentId": {
"type": "number",
"description": "Department ID"
},
"requisitionId": {
"type": "string",
"description": "Requisition ID"
}
}
}greenhouse_list_job_stagesList stages for a specific job
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
}
}
}greenhouse_get_hiring_teamGet the hiring team for a job
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
}
}
}greenhouse_add_hiring_team_memberAdd a member to a job hiring team
{
"type": "object",
"required": [
"jobId",
"userId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
},
"userId": {
"type": "number",
"description": "The user ID to add"
},
"responsible": {
"type": "boolean",
"description": "Whether the user is the responsible recruiter"
}
}
}greenhouse_list_job_openingsList all job openings
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"jobId": {
"type": "number",
"description": "Filter by job ID"
},
"status": {
"enum": [
"open",
"closed"
],
"type": "string",
"description": "Filter by status"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
}
}
}greenhouse_get_job_openingGet a specific job opening
{
"type": "object",
"required": [
"jobId",
"openingId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
},
"openingId": {
"type": "number",
"description": "The opening ID"
}
}
}greenhouse_create_job_openingsCreate new job openings
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
},
"openingIds": {
"type": "array",
"items": {
"type": "string"
},
"description": "Custom opening IDs"
},
"targetStartDate": {
"type": "string",
"description": "Target start date (YYYY-MM-DD)"
},
"numberOfOpenings": {
"type": "number",
"description": "Number of openings to create"
}
}
}greenhouse_update_job_postUpdate a job post
{
"type": "object",
"required": [
"jobPostId"
],
"properties": {
"title": {
"type": "string",
"description": "Job post title"
},
"content": {
"type": "string",
"description": "Job post content (HTML)"
},
"location": {
"type": "string",
"description": "Location"
},
"jobPostId": {
"type": "number",
"description": "The job post ID"
}
}
}greenhouse_update_job_post_statusSet a job post to live or offline
{
"type": "object",
"required": [
"jobPostId",
"status"
],
"properties": {
"status": {
"enum": [
"live",
"offline"
],
"type": "string",
"description": "Job post status"
},
"jobPostId": {
"type": "number",
"description": "The job post ID"
}
}
}greenhouse_list_job_approval_flowsList approval flows for a job
{
"type": "object",
"required": [
"jobId"
],
"properties": {
"jobId": {
"type": "number",
"description": "The job ID"
}
}
}greenhouse_get_approval_flowGet a specific approval flow
{
"type": "object",
"required": [
"approvalFlowId"
],
"properties": {
"approvalFlowId": {
"type": "number",
"description": "The approval flow ID"
}
}
}greenhouse_request_approvalsRequest approvals for a job or offer
{
"type": "object",
"required": [
"requestType"
],
"properties": {
"jobId": {
"type": "number",
"description": "Job ID (for job approvals)"
},
"offerId": {
"type": "number",
"description": "Offer ID (for offer approvals)"
},
"requestType": {
"enum": [
"open_job",
"offer"
],
"type": "string",
"description": "Type of approval request"
},
"requestedByUserId": {
"type": "number",
"description": "User requesting approval"
}
}
}greenhouse_list_offersList all offers with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"status": {
"enum": [
"unresolved",
"accepted",
"rejected",
"deprecated"
],
"type": "string",
"description": "Filter by status"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
},
"sentAfter": {
"type": "string",
"description": "Filter by sent date (ISO 8601)"
},
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"applicationId": {
"type": "number",
"description": "Filter by application ID"
},
"createdBefore": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"resolvedAfter": {
"type": "string",
"description": "Filter by resolved date (ISO 8601)"
}
}
}greenhouse_get_offerGet a specific offer by ID
{
"type": "object",
"required": [
"offerId"
],
"properties": {
"offerId": {
"type": "number",
"description": "The offer ID"
}
}
}greenhouse_list_application_offersList all offers for an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_get_current_offerGet the current offer for an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_update_current_offerUpdate the current offer for an application
{
"type": "object",
"required": [
"applicationId"
],
"properties": {
"startsAt": {
"type": "string",
"description": "Start date (YYYY-MM-DD)"
},
"applicationId": {
"type": "number",
"description": "The application ID"
}
}
}greenhouse_list_departmentsList all departments
{
"type": "object",
"properties": {}
}greenhouse_get_departmentGet a specific department by ID
{
"type": "object",
"required": [
"departmentId"
],
"properties": {
"departmentId": {
"type": "number",
"description": "The department ID"
}
}
}greenhouse_create_departmentCreate a new department
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Department name"
},
"parentId": {
"type": "number",
"description": "Parent department ID"
},
"externalId": {
"type": "string",
"description": "External ID for HRIS integration"
}
}
}greenhouse_update_departmentUpdate a department
{
"type": "object",
"required": [
"departmentId",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Department name"
},
"parentId": {
"type": "number",
"description": "Parent department ID"
},
"externalId": {
"type": "string",
"description": "External ID for HRIS integration"
},
"departmentId": {
"type": "number",
"description": "The department ID"
}
}
}greenhouse_list_officesList all offices
{
"type": "object",
"properties": {}
}greenhouse_get_officeGet a specific office by ID
{
"type": "object",
"required": [
"officeId"
],
"properties": {
"officeId": {
"type": "number",
"description": "The office ID"
}
}
}greenhouse_create_officeCreate a new office
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Office name"
},
"parentId": {
"type": "number",
"description": "Parent office ID"
},
"externalId": {
"type": "string",
"description": "External ID for HRIS integration"
},
"locationName": {
"type": "string",
"description": "Location display name"
},
"primaryContactUserId": {
"type": "number",
"description": "Primary contact user ID"
}
}
}greenhouse_update_officeUpdate an office
{
"type": "object",
"required": [
"officeId",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Office name"
},
"officeId": {
"type": "number",
"description": "The office ID"
},
"parentId": {
"type": "number",
"description": "Parent office ID"
},
"externalId": {
"type": "string",
"description": "External ID for HRIS integration"
},
"locationName": {
"type": "string",
"description": "Location display name"
},
"primaryContactUserId": {
"type": "number",
"description": "Primary contact user ID"
}
}
}greenhouse_list_custom_fieldsList all custom fields
{
"type": "object",
"properties": {
"fieldType": {
"type": "string",
"description": "Filter by field type (job, candidate, application, offer, etc.)"
}
}
}greenhouse_get_custom_fieldGet a specific custom field by ID
{
"type": "object",
"required": [
"customFieldId"
],
"properties": {
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_create_custom_fieldCreate a new custom field
{
"type": "object",
"required": [
"name",
"fieldType",
"valueType"
],
"properties": {
"name": {
"type": "string",
"description": "Field name"
},
"apiOnly": {
"type": "boolean",
"description": "Only accessible via API"
},
"private": {
"type": "boolean",
"description": "Whether field is private"
},
"required": {
"type": "boolean",
"description": "Whether field is required"
},
"fieldType": {
"type": "string",
"description": "Field type (job, candidate, application, offer, etc.)"
},
"valueType": {
"type": "string",
"description": "Value type (short_text, long_text, yes_no, single_select, etc.)"
},
"description": {
"type": "string",
"description": "Field description"
},
"exposeInJobBoardApi": {
"type": "boolean",
"description": "Expose in job board API"
}
}
}greenhouse_update_custom_fieldUpdate a custom field
{
"type": "object",
"required": [
"customFieldId"
],
"properties": {
"name": {
"type": "string",
"description": "Field name"
},
"private": {
"type": "boolean",
"description": "Whether field is private"
},
"required": {
"type": "boolean",
"description": "Whether field is required"
},
"description": {
"type": "string",
"description": "Field description"
},
"customFieldId": {
"type": "number",
"description": "The custom field ID"
},
"exposeInJobBoardApi": {
"type": "boolean",
"description": "Expose in job board API"
}
}
}greenhouse_delete_custom_fieldDelete a custom field
{
"type": "object",
"required": [
"customFieldId"
],
"properties": {
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_list_custom_field_optionsList options for a custom field
{
"type": "object",
"required": [
"customFieldId"
],
"properties": {
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_create_custom_field_optionCreate an option for a custom field
{
"type": "object",
"required": [
"customFieldId",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Option name"
},
"priority": {
"type": "number",
"description": "Display priority"
},
"externalId": {
"type": "string",
"description": "External ID"
},
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_update_custom_field_optionUpdate a custom field option
{
"type": "object",
"required": [
"customFieldId",
"optionId",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Option name"
},
"optionId": {
"type": "number",
"description": "The option ID"
},
"priority": {
"type": "number",
"description": "Display priority"
},
"externalId": {
"type": "string",
"description": "External ID"
},
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_delete_custom_field_optionDelete a custom field option
{
"type": "object",
"required": [
"customFieldId",
"optionId"
],
"properties": {
"optionId": {
"type": "number",
"description": "The option ID"
},
"customFieldId": {
"type": "number",
"description": "The custom field ID"
}
}
}greenhouse_list_email_templatesList all email templates
{
"type": "object",
"properties": {}
}greenhouse_get_email_templateGet a specific email template by ID
{
"type": "object",
"required": [
"templateId"
],
"properties": {
"templateId": {
"type": "number",
"description": "The email template ID"
}
}
}greenhouse_list_sourcesList all candidate sources
{
"type": "object",
"properties": {}
}greenhouse_list_rejection_reasonsList all rejection reasons
{
"type": "object",
"properties": {}
}greenhouse_list_close_reasonsList all job opening close reasons
{
"type": "object",
"properties": {}
}greenhouse_list_prospect_poolsList all prospect pools
{
"type": "object",
"properties": {}
}greenhouse_get_prospect_poolGet a specific prospect pool by ID
{
"type": "object",
"required": [
"poolId"
],
"properties": {
"poolId": {
"type": "number",
"description": "The prospect pool ID"
}
}
}greenhouse_list_degreesList all degree types
{
"type": "object",
"properties": {}
}greenhouse_list_disciplinesList all academic disciplines
{
"type": "object",
"properties": {}
}greenhouse_list_schoolsList all schools
{
"type": "object",
"properties": {}
}greenhouse_get_tracking_linkGet tracking link data by token
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "The tracking link token"
}
}
}greenhouse_list_usersList all users in Greenhouse with optional filters
{
"type": "object",
"properties": {
"page": {
"type": "number",
"description": "Page number"
},
"email": {
"type": "string",
"description": "Filter by email"
},
"perPage": {
"type": "number",
"description": "Number of results per page"
},
"employeeId": {
"type": "string",
"description": "Filter by employee ID"
},
"createdAfter": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"updatedAfter": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
},
"createdBefore": {
"type": "string",
"description": "Filter by created date (ISO 8601)"
},
"updatedBefore": {
"type": "string",
"description": "Filter by updated date (ISO 8601)"
}
}
}greenhouse_get_userGet a specific user by ID
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "number",
"description": "The user ID"
}
}
}greenhouse_create_userCreate a new user in Greenhouse
{
"type": "object",
"required": [
"firstName",
"lastName",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "Email address"
},
"lastName": {
"type": "string",
"description": "Last name"
},
"firstName": {
"type": "string",
"description": "First name"
},
"officeIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Office IDs"
},
"sendEmail": {
"type": "boolean",
"description": "Send welcome email"
},
"employeeId": {
"type": "string",
"description": "Employee ID"
},
"departmentIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Department IDs"
},
"disableUserOnCreate": {
"type": "boolean",
"description": "Create user as disabled"
}
}
}greenhouse_update_userUpdate an existing user
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "number",
"description": "The user ID"
},
"lastName": {
"type": "string",
"description": "Last name"
},
"firstName": {
"type": "string",
"description": "First name"
},
"officeIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Office IDs"
},
"employeeId": {
"type": "string",
"description": "Employee ID"
},
"departmentIds": {
"type": "array",
"items": {
"type": "number"
},
"description": "Department IDs"
}
}
}greenhouse_disable_userDisable a user
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "number",
"description": "The user ID"
}
}
}greenhouse_enable_userEnable a disabled user
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "number",
"description": "The user ID"
}
}
}greenhouse_get_pending_approvalsGet pending approvals for a user
{
"type": "object",
"required": [
"userId"
],
"properties": {
"userId": {
"type": "number",
"description": "The user ID"
}
}
}greenhouse_list_user_rolesList all user roles
{
"type": "object",
"properties": {}
}