Ashby
Authentication: API key. See Magic Link for the runtime auth flow.
Available Tools
List applications in Ashby with cursor pagination, optionally filtered by job. Returns applications and page_info.
Get an application’s details by ID, including candidate, current stage, and source. Use list_applications to find valid…
Create an application for a candidate on a job. Requires candidate_id and job_id. Returns the created application. Use l…
Update an application’s source or credited user. Only provide what should change. Use list_applications to find valid ID…
Move an application to a different interview stage. Returns the updated application. Use list_interview_stages to find v…
Change the source attributed to an application. Returns the updated application. Use list_sources to find valid source I…
List the history of an application (stage changes and other events) with cursor pagination. Use list_applications to fin…
List feedback submissions for an application. Use list_applications to find valid IDs.
Submit feedback for an application using a feedback form. Requires the form definition ID, submitting user ID, and field…
List candidates in Ashby with cursor pagination. Returns candidates and page_info with a cursor for the next page.
Get a candidate’s full profile by ID, including contact info, tags, and application IDs. Use list_candidates or search_c…
Search candidates by email and/or name. Provide at least one of email or name. Returns matching candidates.
Create a new candidate. Requires a name; email, phone, social links, location, and source are optional. Returns the crea…
Update a candidate’s profile. All fields except candidate_id are optional, only provide what should change. Use list_can…
Add a note to a candidate’s profile. Returns the created note. Use list_candidates to find valid IDs.
List notes on a candidate’s profile with cursor pagination. Use list_candidates to find valid IDs.
Add an existing tag to a candidate. Returns the updated candidate. Use list_candidate_tags for tag IDs and list_candidat…
Remove a tag from a candidate. Returns the updated candidate. Use list_candidate_tags for tag IDs and list_candidates fo…
List candidate tags in the organization with cursor pagination. Returns tags and page_info.
Create a new candidate tag with the given title. Returns the created tag.
Upload and parse a resume for a candidate. Provide the file as base64. Parsed data only fills fields missing on the cand…
Get a temporary download URL for a file by its handle, e.g. a candidate’s resumeFileHandle.handle from get_candidate. Re…
List interview types configured in Ashby with cursor pagination. Returns interviews and page_info.
Get an interview type’s details by ID. Use list_interviews to find valid IDs.
List scheduled interviews with cursor pagination, optionally filtered by application. Returns schedules and page_info.
Cancel a scheduled interview. Returns the updated schedule. Use list_interview_schedules to find valid IDs.
List the interview stages for an interview plan. Provide an interview_plan_id (found on a job via get_job’s interviewPla…
Get an interview stage’s details by ID. Use list_interview_stages to find valid IDs.
List jobs in Ashby with cursor pagination, optionally filtered by status (Open, Closed, Archived, Draft). Returns jobs a…
Get a job’s details by ID, including status, location, department, hiring team, and interview plan IDs. Use list_jobs to…
Search jobs by title. Returns matching jobs.
Create a new job. Requires a title and team_id (department). Returns the created job. Use list_departments to find valid…
Update a job’s title, location, department, or employment type. Only provide what should change. Use list_jobs to find v…
Set a job’s status (Draft, Open, Closed, Archived). Returns the updated job. Use list_jobs to find valid IDs.
List published job postings (the public-facing listings for jobs). Returns postings with links and location info.
Get a job posting’s details by ID. Use list_job_postings to find valid IDs.
Update a job posting’s title, description, or listed status. Only provide what should change. Use list_job_postings to f…
List offers in Ashby with cursor pagination, each with its latest version. Returns offers and page_info.
Get an offer’s details by ID, including its latest version (salary, start date, status). Use list_offers to find valid I…
List openings (headcount/requisitions) in Ashby with cursor pagination. Returns openings and page_info.
Get an opening’s details by ID, including its latest version (jobs, locations, hiring team). Use list_openings to find v…
Search openings by their identifier. Returns matching openings.
Create a new opening (headcount/requisition). All fields are optional. Returns the created opening. Use list_departments…
Update an opening’s identifier, description, or target dates. Only provide what should change. Use list_openings to find…
List Ashby users (recruiters, hiring managers, interviewers). Returns users and page_info.
Get an Ashby user’s details by ID. Use list_users to find valid IDs.
Search for an Ashby user by email address. Returns matching users.
List departments in Ashby. Returns departments and page_info.
Get a department’s details by ID. Use list_departments to find valid IDs.
List locations in Ashby. Returns locations and page_info.
Get a location’s details by ID, including address. Use list_locations to find valid IDs.
List candidate sources (how candidates entered the pipeline) configured in Ashby.
List archive reasons (rejection reasons) configured in Ashby.
List custom field definitions configured in Ashby with cursor pagination. Returns custom fields and page_info.
Get a custom field definition’s details by ID. Use list_custom_fields to find valid IDs.
List feedback form definitions configured in Ashby with cursor pagination. Returns forms and page_info.
Get a feedback form definition’s structure (sections and fields) by ID. Use list_feedback_forms to find valid IDs.
List projects (talent pools) in Ashby with cursor pagination. Returns projects and page_info.
Get a project’s details by ID. Use list_projects to find valid IDs.
Search projects by title. Returns matching projects.
Fetch a report’s results synchronously by report ID. Returns column names and data rows. Times out after 30s; use genera…
Generate a report’s results asynchronously. Call without request_id to start generation (returns a request_id and status…
Validate Ashby credentials by verifying API access. Returns success status and the API key title.