Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Connect Greenhouse to your Atako agents — 12 read and 5 write actions.
| Action | Description |
|---|---|
get_application | Fetch a single application by id. Returns application details, current stage, and candidate info. |
get_candidate | Fetch a single candidate by id. Returns full candidate profile including applications, email addresses, phone numbers and social media profiles. |
get_job | Fetch a single job by id. Returns id, title, department, office, hiring team, and custom fields. |
list_applications | List applications. Optional filters: job_id (integer), status (string: “active”, “rejected”, “hired”, “pending”, “sourced”, “recruiter_concluded”), last_activity_after (ISO 8601 datetime), per_page (1-100), page (page number). |
list_candidates | List candidates. Optional filters: email (string, exact match), job_id (integer, candidates who applied to this job), created_after (ISO 8601 datetime), updated_after (ISO 8601 datetime), per_page (1-100), page (page number). |
list_departments | List departments. Optional: per_page (1-100), page (page number). |
list_job_posts | List job posts. Optional: live (boolean, default true), active (boolean), per_page (1-100), page (page number). |
list_jobs | List jobs. Optional filters: status (“open”, “closed”, “draft”, “all”), department_id (integer), office_id (integer), per_page (1-100), page (page number). |
list_offices | List offices. Optional: per_page (1-100), page (page number). |
list_scheduled_interviews | List scheduled interviews. Optional filters: starts_after (ISO 8601 datetime), ends_before (ISO 8601 datetime), per_page (1-100), page (page number). |
list_scorecards | List scorecards submitted for a given application. Returns interviewer name, overall recommendation, and individual question scores. |
list_users | List users in the Greenhouse account. Optional: per_page (1-100, default 100), page (page number). Returns id, name, email, title, and enabled permissions. |
| Action | Description |
|---|---|
add_application | Add an application for an existing candidate on a job. Arguments: candidate_id: integer (candidate id — see list_candidates or get_candidate); job_id: integer (job id to apply to — see list_jobs); on_behalf_of_user_id: string (Greenhouse user id, sent as the On-Behalf-Of header). |
add_candidate_note | Add a note to a candidate’s activity feed. Arguments: candidate_id: integer (candidate id — see list_candidates or get_candidate); body: string (note body, plain text or XHTML); visibility: optional string (“public” or “private”, default “public”); on_behalf_of_user_id: string (Greenhouse user id of the note author, sent as the On-Behalf-Of header). |
create_candidate | Create a new candidate. Arguments: first_name: string (first name); last_name: string (last name); email_addresses: array of objects {value: string, type: string (“home”, “work”, “other”)} (candidate email addresses); phone_numbers: optional array of objects {value: string, type: string (“home”, “work”, “mobile”, “other”)} (candidate phone numbers); company: optional string (current company); title: optional string (current job title); applications: optional array of objects {job_id: integer} (jobs to apply the candidate to); on_behalf_of_user_id: string (Greenhouse user id of the person creating the candidate, sent as the On-Behalf-Of header — see list_users). |
move_application | Move an application to a different stage. Arguments: application_id: integer (application id — see list_applications or get_application); from_stage_id: integer (current stage id); to_stage_id: integer (target stage id); on_behalf_of_user_id: string (Greenhouse user id, sent as the On-Behalf-Of header). |
reject_application | Reject an application. Arguments: application_id: integer (application id — see list_applications or get_application); rejection_reason_id: integer (optional rejection reason id); notes: optional string (rejection notes, plain text); on_behalf_of_user_id: string (Greenhouse user id, sent as the On-Behalf-Of header). |
