Prerequisites
The connector should already be set up, with a Connector Profile and a Linked Account. See Getting Started on the Ashby connector page.How Ashby webhooks are set up
There is nothing to paste into Ashby and no URL to copy. For each event you enable in StackOne, StackOne creates an Ashby webhook for it and removes it again when the account is disconnected.
- Ashby takes one Webhook Type per webhook, so each enabled event becomes its own webhook in Ashby.
- You can review the webhooks StackOne created in Ashby under Admin > Integrations > Webhooks. Don’t edit or delete them there. Manage events in StackOne instead.
Before you enable events
Webhooks are created with the API key on this connection, so the key must be allowed to manage them.
- Give the API key write access to the API Keys module. Ashby lists webhook create, update and delete under that module.
- Give the key read access to the modules whose data you want events for, such as candidates, jobs, interviews and offers.
- Events for features your organization doesn’t use, such as an HRIS integration, e-signature or take-home assignments, are only sent once that feature is set up in Ashby.
Available webhook events
The following Ashby events can be enabled. Only events selected in StackOne get a webhook in Ashby, and Ashby doesn’t send events it has no webhook for.
Ping
Handled automatically whenever any other event is enabled.
- Active Check (
ping) — Fired when a webhook is created or edited, to check the URL is live. Ashby disables a webhook whose ping isn’t answered.
Application events
Events on candidate applications, from submission to hire.
- Application Submitted (
applicationSubmit) — Fired when a candidate submits an application or is added to a job manually. Bulk imports and integration syncs do not fire it - Application Updated (
applicationUpdate) — Fired when an application changes, such as its source, custom fields or a transfer to another job. Stage changes and hires also fire it - Candidate Stage Changed (
candidateStageChange) — Fired when an application moves to another interview stage. Hires also fire it - Candidate Hired (
candidateHire) — Fired when a candidate is hired, including on confidential jobs. The payload carries the application and the most recent accepted offer - Candidate Pushed to HRIS (
pushToHRIS) — Fired when a hired candidate is pushed to the connected HRIS
Candidate events
Events on candidate records and surveys.
- Candidate Deleted (
candidateDelete) — Fired when a candidate is deleted. The payload carries only the deleted candidate’s id - Candidate Merged (
candidateMerge) — Fired when two candidates are merged. The payload carries the id of the deleted candidate and of the candidate it was merged into - Candidate Recent Email Messages Updated (
candidateRecentEmailMessagesUpdated) — Fired when a candidate’s recent email messages change. Beta in Ashby and not available to every organization - Survey Submitted (
surveySubmit) — Fired when a candidate submits a non-anonymous survey
Interview events
Events on interview plans, schedules and take-home assignments.
- Interview Plan Transitioned (
interviewPlanTransition) — Fired when a job switches to a different interview plan. The payload carries both plans and the stage mappings. It also fires the job updated event - Interview Schedule Created (
interviewScheduleCreate) — Fired when an interview schedule is created. It also fires the interview schedule updated event - Interview Schedule Updated (
interviewScheduleUpdate) — Fired when an interview schedule changes, including when its interviews are scheduled, updated or canceled - Take Home Assignment Assigned (
takeHomeAssignmentAssigned) — Fired when a take-home assignment is assigned to a candidate - Take Home Assignment Submitted (
takeHomeAssignmentSubmitted) — Fired when a candidate submits a take-home assignment - Take Home Assignment Completed (
takeHomeAssignmentCompleted) — Fired when a take-home assignment is marked completed - Take Home Assignment Cancelled (
takeHomeAssignmentCancelled) — Fired when a take-home assignment is canceled
Job, job posting and opening events
Events on jobs, their postings and openings.
- Job Created (
jobCreate) — Fired when a job is created - Job Updated (
jobUpdate) — Fired when a job changes. An interview plan transition also fires it - Job Posting Published (
jobPostingPublish) — Fired when a job posting is published. It also fires the job posting updated event - Job Posting Updated (
jobPostingUpdate) — Fired when a job posting changes, including when it is published or unpublished - Job Posting Unpublished (
jobPostingUnpublish) — Fired when a job posting is unpublished. It also fires the job posting updated event - Job Posting Deleted (
jobPostingDelete) — Fired when a job posting is deleted. The payload carries the posting id and its job id - Opening Created (
openingCreate) — Fired when a job opening is created - Opening Updated (
openingUpdate) — Fired when a job opening changes - Opening Deleted (
openingDelete) — Fired when a job opening is deleted
Offer events
Events on offers and their e-signature requests.
- Offer Created (
offerCreate) — Fired when a new offer process is created for a candidate - Offer Updated (
offerUpdate) — Fired when an offer changes - Offer Deleted (
offerDelete) — Fired when an offer process is deleted. The payload carries only the offer id - Signature Request Updated (
signatureRequestUpdate) — Fired when an e-signature request on an application or offer is sent, canceled, completed or deleted (data.eventType)