Ashby

Connect your AI agents to Ashby.

Authentication: API key. See Magic Link for the runtime auth flow.

Available Tools

list_applications

List applications in Ashby with cursor pagination, optionally filtered by job. Returns applications and page_info.

get_application

Get an application’s details by ID, including candidate, current stage, and source. Use list_applications to find valid…

create_application

Create an application for a candidate on a job. Requires candidate_id and job_id. Returns the created application. Use l…

update_application

Update an application’s source or credited user. Only provide what should change. Use list_applications to find valid ID…

change_application_stage

Move an application to a different interview stage. Returns the updated application. Use list_interview_stages to find v…

change_application_source

Change the source attributed to an application. Returns the updated application. Use list_sources to find valid source I…

list_application_history

List the history of an application (stage changes and other events) with cursor pagination. Use list_applications to fin…

list_application_feedback

List feedback submissions for an application. Use list_applications to find valid IDs.

submit_application_feedback

Submit feedback for an application using a feedback form. Requires the form definition ID, submitting user ID, and field…

list_candidates

List candidates in Ashby with cursor pagination. Returns candidates and page_info with a cursor for the next page.

get_candidate

Get a candidate’s full profile by ID, including contact info, tags, and application IDs. Use list_candidates or search_c…

search_candidates

Search candidates by email and/or name. Provide at least one of email or name. Returns matching candidates.

create_candidate

Create a new candidate. Requires a name; email, phone, social links, location, and source are optional. Returns the crea…

update_candidate

Update a candidate’s profile. All fields except candidate_id are optional, only provide what should change. Use list_can…

create_candidate_note

Add a note to a candidate’s profile. Returns the created note. Use list_candidates to find valid IDs.

list_candidate_notes

List notes on a candidate’s profile with cursor pagination. Use list_candidates to find valid IDs.

add_candidate_tag

Add an existing tag to a candidate. Returns the updated candidate. Use list_candidate_tags for tag IDs and list_candidat…

remove_candidate_tag

Remove a tag from a candidate. Returns the updated candidate. Use list_candidate_tags for tag IDs and list_candidates fo…

list_candidate_tags

List candidate tags in the organization with cursor pagination. Returns tags and page_info.

create_candidate_tag

Create a new candidate tag with the given title. Returns the created tag.

upload_resume

Upload and parse a resume for a candidate. Provide the file as base64. Parsed data only fills fields missing on the cand…

get_file_url

Get a temporary download URL for a file by its handle, e.g. a candidate’s resumeFileHandle.handle from get_candidate. Re…

list_interviews

List interview types configured in Ashby with cursor pagination. Returns interviews and page_info.

get_interview

Get an interview type’s details by ID. Use list_interviews to find valid IDs.

list_interview_schedules

List scheduled interviews with cursor pagination, optionally filtered by application. Returns schedules and page_info.

cancel_interview_schedule

Cancel a scheduled interview. Returns the updated schedule. Use list_interview_schedules to find valid IDs.

list_interview_stages

List the interview stages for an interview plan. Provide an interview_plan_id (found on a job via get_job’s interviewPla…

get_interview_stage

Get an interview stage’s details by ID. Use list_interview_stages to find valid IDs.

list_jobs

List jobs in Ashby with cursor pagination, optionally filtered by status (Open, Closed, Archived, Draft). Returns jobs a…

get_job

Get a job’s details by ID, including status, location, department, hiring team, and interview plan IDs. Use list_jobs to…

search_jobs

Search jobs by title. Returns matching jobs.

create_job

Create a new job. Requires a title and team_id (department). Returns the created job. Use list_departments to find valid…

update_job

Update a job’s title, location, department, or employment type. Only provide what should change. Use list_jobs to find v…

set_job_status

Set a job’s status (Draft, Open, Closed, Archived). Returns the updated job. Use list_jobs to find valid IDs.

list_job_postings

List published job postings (the public-facing listings for jobs). Returns postings with links and location info.

get_job_posting

Get a job posting’s details by ID. Use list_job_postings to find valid IDs.

update_job_posting

Update a job posting’s title, description, or listed status. Only provide what should change. Use list_job_postings to f…

list_offers

List offers in Ashby with cursor pagination, each with its latest version. Returns offers and page_info.

get_offer

Get an offer’s details by ID, including its latest version (salary, start date, status). Use list_offers to find valid I…

list_openings

List openings (headcount/requisitions) in Ashby with cursor pagination. Returns openings and page_info.

get_opening

Get an opening’s details by ID, including its latest version (jobs, locations, hiring team). Use list_openings to find v…

search_openings

Search openings by their identifier. Returns matching openings.

create_opening

Create a new opening (headcount/requisition). All fields are optional. Returns the created opening. Use list_departments…

update_opening

Update an opening’s identifier, description, or target dates. Only provide what should change. Use list_openings to find…

list_users

List Ashby users (recruiters, hiring managers, interviewers). Returns users and page_info.

get_user

Get an Ashby user’s details by ID. Use list_users to find valid IDs.

search_users

Search for an Ashby user by email address. Returns matching users.

list_departments

List departments in Ashby. Returns departments and page_info.

get_department

Get a department’s details by ID. Use list_departments to find valid IDs.

list_locations

List locations in Ashby. Returns locations and page_info.

get_location

Get a location’s details by ID, including address. Use list_locations to find valid IDs.

list_sources

List candidate sources (how candidates entered the pipeline) configured in Ashby.

list_archive_reasons

List archive reasons (rejection reasons) configured in Ashby.

list_custom_fields

List custom field definitions configured in Ashby with cursor pagination. Returns custom fields and page_info.

get_custom_field

Get a custom field definition’s details by ID. Use list_custom_fields to find valid IDs.

list_feedback_forms

List feedback form definitions configured in Ashby with cursor pagination. Returns forms and page_info.

get_feedback_form

Get a feedback form definition’s structure (sections and fields) by ID. Use list_feedback_forms to find valid IDs.

list_projects

List projects (talent pools) in Ashby with cursor pagination. Returns projects and page_info.

get_project

Get a project’s details by ID. Use list_projects to find valid IDs.

search_projects

Search projects by title. Returns matching projects.

get_report

Fetch a report’s results synchronously by report ID. Returns column names and data rows. Times out after 30s; use genera…

generate_report

Generate a report’s results asynchronously. Call without request_id to start generation (returns a request_id and status…

validate_credential

Validate Ashby credentials by verifying API access. Returns success status and the API key title.