Ashby API

12 endpoints for Ashby, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/ashby
Connects with: Your own Ashby account (Elevated Access or Organization Admin for scheduling and offers)
Integration page: Ashby

Read (7)

Return data and change nothing in the account.

Ashby Endpoints: Read
Endpoint	Description
GET /jobs	Jobs with title, status, department and hiring team, open jobs by default.
GET /candidates/search	Candidates by name or email, with their applications and current stage.
GET /candidates/{candidate_id}	One candidate profile: applications, stage, notes, recent emails and scheduled interviews.
GET /jobs/{job_id}/applications	Applications of a job with candidate, stage, status and days in stage, newest update first.
GET /interviews	Scheduled interviews with time, interviewers and candidate, for one candidate or a date range.
GET /archive-reasons	The archive reasons your admin set up, to use in archive_application.
GET /email-templates	The email templates your account can apply, with name and purpose.

Change the account. Calls marked Confirm wait for the user to approve them.

Ashby Endpoints: Write
Endpoint	Description
POST /applications/{application_id}/interview/schedule Confirm	Schedule an interview for an application with interviewers, time, video link and invite settings.
POST /candidates/{candidate_id}/emails Confirm	Send an email to a candidate from a template or your own text, now or at a set time.
POST /applications/{application_id}/archive Confirm	Reject an application with an archive reason, an optional note and an optional rejection email.
POST /applications/{application_id}/offers Confirm	Create an offer for an application in the Offer stage from your offer form fields.
POST /offers/{offer_id}/letter Confirm	Generate the offer letter, email it to the candidate and optionally request an e-signature.