Skip to main content

Ashby

ATS connector for managing candidates, applications, jobs, interviews, and offers in Ashby.

Set up​

Ashby connects with credentials from your Ashby account. Have these values ready:

  • API key
  1. Go to Organization > Connectors and find Ashby.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Ashby offers 67 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (48)​

View and search information without changing it.

ToolWhat it does
generate_reportGenerate a report's results asynchronously.
get_applicationGet an application's details by ID, including candidate, current stage, and source.
get_candidateGet a candidate's full profile by ID, including contact info, tags, and application IDs.
get_custom_fieldGet a custom field definition's details by ID.
get_departmentGet a department's details by ID.
get_feedback_formGet a feedback form definition's structure (sections and fields) by ID.
get_file_urlGet a temporary download URL for a file by its handle, e.g. a candidate's resumeFileHandle.handle from get_candidate.
get_interviewGet an interview type's details by ID.
get_interview_stageGet an interview stage's details by ID.
get_jobGet a job's details by ID, including status, location, department, hiring team, and interview plan IDs.
get_job_postingGet a job posting's details by ID.
get_locationGet a location's details by ID, including address.
get_offerGet an offer's details by ID, including its latest version (salary, start date, status).
get_openingGet an opening's details by ID, including its latest version (jobs, locations, hiring team).
get_projectGet a project's details by ID.
get_reportFetch a report's results synchronously by report ID.
get_userGet an Ashby user's details by ID.
list_application_feedbackList feedback submissions with cursor pagination, for one application or (with application_id null) across all applications, optionally only those created after a time.
list_application_historyList the history of an application (stage changes and other events) with cursor pagination.
list_applicationsList applications in Ashby with cursor pagination.
list_archive_reasonsList archive reasons (rejection reasons) configured in Ashby.
list_candidate_notesList notes on a candidate's profile with cursor pagination.
list_candidate_tagsList candidate tags in the organization with cursor pagination.
list_candidatesList candidates in Ashby with cursor pagination.
list_custom_fieldsList custom field definitions configured in Ashby with cursor pagination.
list_departmentsList departments in Ashby.
list_feedback_formsList feedback form definitions configured in Ashby with cursor pagination.
list_interview_eventsList the interview events (individual scheduled interviews) on an interview schedule, with cursor pagination.
list_interview_plansList published interview plans with cursor pagination.
list_interview_schedulesList interview schedules with cursor pagination, optionally filtered by application, interview stage, or creation time, or updated since a sync_token.
list_interview_stagesList the interview stages for an interview plan.
list_interviewsList interview types configured in Ashby with cursor pagination.
list_job_boardsList the organization's job boards.
list_job_postingsList job postings (the public-facing listings for jobs), optionally filtered by location or department name, listed-only, or job board.
list_job_templatesList job templates with cursor pagination.
list_jobsList jobs in Ashby with cursor pagination.
list_locationsList locations in Ashby.
list_offersList offers in Ashby with cursor pagination, each with its latest version.
list_openingsList openings (headcount/requisitions) in Ashby with cursor pagination, optionally only those created after a time or updated since a sync_token.
list_projectsList projects (talent pools) in Ashby with cursor pagination, optionally only those created after a time or updated since a sync_token.
list_sourcesList candidate sources (how candidates entered the pipeline) configured in Ashby.
list_usersList Ashby users (recruiters, hiring managers, interviewers).
search_candidatesSearch candidates by email and/or name.
search_jobsSearch jobs by title and/or custom requisition ID (substring match).
search_openingsSearch openings by their identifier.
search_projectsSearch projects by title.
search_usersSearch for an Ashby user by email address.
validate_credentialValidate Ashby credentials by verifying API access.

Write (8)​

Create or send data.

ToolWhat it does
add_candidate_tagAdd an existing tag to a candidate.
create_applicationCreate an application for a candidate on a job.
create_candidateCreate a new candidate.
create_candidate_noteAdd a note to a candidate's profile.
create_candidate_tagCreate a new candidate tag with the given title.
create_jobCreate a new job.
create_openingCreate a new opening (headcount/requisition).
upload_resumeUpload and parse a resume for a candidate.

Delete or overwrite (11)​

Remove or replace existing data.

ToolWhat it does
cancel_interview_scheduleCancel a scheduled interview.
change_application_sourceChange the source attributed to an application.
change_application_stageMove an application to a different interview stage.
remove_candidate_tagRemove a tag from a candidate.
set_job_statusSet a job's status (Draft, Open, Closed, Archived).
submit_application_feedbackSubmit feedback for an application using a feedback form.
update_applicationUpdate an application's source or credited user.
update_candidateUpdate a candidate's profile.
update_jobUpdate a job's title, location, department (team_id), employment type, default interview plan, or custom requisition ID.
update_job_postingUpdate a job posting's title, HTML description, or workplace type.
update_openingUpdate an opening's identifier, description, or target dates.
⌘J