AI agents for Ashby

Search candidates

Finds candidates by email address and/or name (at least one).

List candidates

Lists candidates page by page, optionally only those created after a time (Unix milliseconds).

Get a candidate

Reads one candidate by Ashby ID.

List a candidate's notes

Lists the notes on a candidate, newest first.

List jobs

Lists jobs, optionally only those in some statuses (Draft, Open, Closed, Archived).

Get a job

Reads one job by ID, with its location and openings.

List applications

Lists applications, optionally for one job, of one status (Active, Hired, Archived, Lead) or created after a time (Unix milliseconds).

Get an application

Reads one application by ID.

List interview stages

Lists the stages of an interview plan in order (the plan ID is a job's defaultInterviewPlanId or an application's currentInterviewStage.interviewPlanId).

List archive reasons

Lists the reasons an application can be archived with.

Create a candidate

Adds a new candidate with a full name and, optionally, a personal email, phone number, LinkedIn, GitHub and website URLs and a location.

Add a note to a candidate

Adds a plain-text note to a candidate's profile, optionally private (needs the key's private-fields permission) and optionally notifying the users who follow the candidate.

Consider a candidate for a job

Creates an application for an existing candidate on a job, in the job's default interview plan, at a given interview stage or else its first Lead stage.

Move an application to a stage

Moves an application to another interview stage of its interview plan (IDs from "List interview stages").