Ashby

Manage candidates, jobs, and interviews in Ashby.

Advance an application to the next stage and optionally add a note.

Parameters

Parameter	Type	Required	Description
`application_id`	string	Yes	The Ashby application ID.
`stage_id`	string	Yes	The target stage ID.
`note`	string	No	Optional note explaining the stage change.

Response

{}

Attach a candidate to a job by creating a new application in Ashby.

Parameters

Parameter	Type	Required	Description
`job_id`	string	Yes	The Ashby job ID.
`candidate_id`	string	Yes	The Ashby candidate ID.
`source`	string	No	Optional application source (e.g., Referral, Agency).
`resume_url`	string	No	Optional resume link if not already on the candidate profile.

Response

{}

Create a new candidate profile in Ashby with contact information.

Parameters

Parameter	Type	Required	Description
`first_name`	string	Yes	The candidate's first name.
`last_name`	string	Yes	The candidate's last name.
`email`	string	Yes	The candidate's email address.
`phone`	string	No	Optional phone number.
`resume_url`	string	No	Link to the candidate's resume or profile.

Response

{}

Fetch job details from Ashby by job ID.

Parameters

Parameter	Type	Required	Description
`job_id`	string	Yes	The Ashby job ID.

Response

{}

Retrieve jobs from Ashby filtered by status, department, or location.

Parameters

Parameter	Type	Required	Description
`status`	string	No	Filter by job status (e.g., open, closed).
`department`	string	No	Filter by department name.
`location`	string	No	Filter by job location.

Response

{
  "jobs": [
    {}
  ]
}

Schedule an interview for an Ashby application with time and interviewer details.

Parameters

Parameter	Type	Required	Description
`application_id`	string	Yes	The Ashby application ID.
`start_time`	string	Yes	Interview start time in ISO 8601 format.
`end_time`	string	Yes	Interview end time in ISO 8601 format.
`interviewer_email`	string	Yes	Email address of the interviewer.
`location`	string	No	Optional meeting location or conferencing link.

Response

{}