Integrations / Recruiting

Ashby

Look up candidates, applications, jobs and interview stages, add notes, move applications between stages, and trigger workflows from Ashby hiring events.

7 tools 18 trigger events

Tools

ashby.search_candidates

Find candidates by email and/or name. Candidate IDs are UUIDs.

emailnamelimit

ashby.get_candidate

Get a candidate by ID (a UUID), with contact details, tags, links and application IDs.

id*

ashby.get_application

Get an application by ID (a UUID), with its candidate, job, status, current interview stage and hiring team.

applicationId*

ashby.list_jobs

List jobs, optionally by status, with their interview plan IDs and hiring team. Job IDs are UUIDs.

statuslimit

ashby.list_interview_stages

List an interview plan's stages in order, to find the stage ID to move an application to. The plan ID is a UUID from an application's current stage or a job's defaultInterviewPlanId.

interviewPlanId*

ashby.create_candidate_note writes

Add a note to a candidate's profile. Candidate IDs are UUIDs.

candidateId*note*sendNotifications

ashby.change_application_stage writes

Move an application to another interview stage. Application and stage IDs are UUIDs; moving to an Archived stage needs an archive reason ID.

applicationId*interviewStageId*archiveReasonId

Connect

  1. In Ashby, open the admin API keys page (app.ashbyhq.com/admin/api/keys) and create a key.
  2. Grant it read access to Candidates, Jobs, Interviews and API Keys, plus Candidates write if workflows add notes or change stages. Tick "Allow access to confidential jobs and projects?" if workflows need them.
  3. Paste the key as the connection's API key.
  4. To trigger workflows, open Admin → Integrations → Webhooks, create a webhook for each event type you need with the URL shown on the connection page, set a secret token, and paste the same token on the connection.

Credentials

API key Webhook secret token

Ashby API docs

Triggers

In Ashby, open Admin → Integrations → Webhooks, create a webhook for each event type your workflows use with this URL and a secret token, and paste the same token on this connection.

Events

applicationSubmitapplicationUpdatecandidateStageChangecandidateHirecandidateDeletecandidateMergeinterviewScheduleCreateinterviewScheduleUpdateofferCreateofferUpdateofferDeletejobCreatejobUpdatejobPostingPublishjobPostingUnpublishopeningCreatesurveySubmittakeHomeAssignmentSubmitted
 trigger
kind: ashby
connection: ashby
events: [applicationSubmit]
jobs: [...]

Your next automation is one sentence away.

14-day free trial with $5 of built-in AI included. Cancel anytime.

Start free trial Talk to us