Reference · Tools

Workable Trigger

Starts workflow when Workable recruiting events occur via webhooks

Webhook trigger Productivity v1

The Workable Trigger fires when a candidate is created or moved in Workable, optionally scoped to a specific job or hiring stage. A typical build is notifying the hiring manager and creating an interview task whenever a candidate reaches the on-site stage.

Node type
Webhook trigger
Parameters
2
Outputs
Output
Credentials
Workable

Workable Trigger

Triggers on Workable candidate events such as creation and stage movement

Overview

Receives webhook notifications from Workable when candidate-related events occur in your recruiting pipeline. Supports two event types: candidate_created (when a new candidate is added) and candidate_moved (when a candidate moves to a different hiring stage). Optionally filter by specific job or hiring stage. The incoming webhook payload is passed through as-is from Workable, typically containing candidate details, job information, and stage data. Useful for automating recruiting workflows such as notifying hiring managers, syncing candidates to an ATS or CRM, tracking pipeline movement, and triggering onboarding processes when candidates reach the hired stage.

Category: Productivity
Tool Name: workable_trigger
Version: 1

Appearance: Icon: lucide-Briefcase | Color: #00756a

Node Type

Trigger — webhook (receives incoming HTTP callbacks)

Input / Output

DirectionPort(s)
InputNone (trigger node)
OutputOutput

Credentials

This tool requires Workable credentials. See the Credentials Guide for setup instructions.

Parameters

ParameterTypeRequiredDefaultDescription
Trigger OnoptionsYesThe event type to listen for from Workable.
Options: candidateCreated, candidateMoved
FilterscollectionNo{}Optional filters to narrow which events trigger the workflow.
— JobstringNoGet notifications only for a specific job. Enter the job shortcode from Workable (e.g. the code shown in the job URL).
— StagestringNoGet notifications for a specific hiring stage only (e.g. “hired”, “interview”). Enter the stage slug from Workable.

Output Data

Each accepted notification produces one output item containing the raw Workable payload exactly as it arrived — typically the candidate details, the job it belongs to, and the stage data — plus:

  • _trigger — always workable_webhook
  • _timestamp — ISO 8601 timestamp of when the notification was received
  • _webhookEvent — the payload’s event field, falling back to type, or unknown when neither is present

Reference the payload downstream by expression, e.g. {{ $json.data.candidate.email }}.

Usage Examples

  • Start a workflow when a new candidate is added to Workable
  • Trigger a notification when a candidate moves to the interview stage
  • Automate onboarding tasks when a candidate is moved to the hired stage
  • Sync new candidate data to a CRM when they are created in Workable

Example Configuration

Every new candidate, across all jobs:

{
  "name": "Workable New Candidate Trigger",
  "type": "workable_trigger",
  "parameters": {
    "triggerOn": "candidateCreated"
  }
}

Candidate movement on one job:

{
  "name": "Workable Developer Candidate Moved",
  "type": "workable_trigger",
  "parameters": {
    "triggerOn": "candidateMoved",
    "filters": {
      "job": "ABCD1234"
    }
  }
}

Candidates reaching the hired stage — a good place to start onboarding:

{
  "name": "Workable Hired Candidates",
  "type": "workable_trigger",
  "parameters": {
    "triggerOn": "candidateMoved",
    "filters": {
      "stage": "hired"
    }
  }
}

Both filters combined for a precisely targeted trigger:

{
  "name": "Workable Marketing Interview Candidates",
  "type": "workable_trigger",
  "parameters": {
    "triggerOn": "candidateMoved",
    "filters": {
      "job": "MKTG5678",
      "stage": "interview"
    }
  }
}

Trigger Behavior

  • Activation: When the workflow is activated, a webhook endpoint is registered with the service.
  • Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
  • Payload: The incoming webhook payload is parsed and output as workflow items.
  • Verification: Supports signature verification where applicable.

Tips

Entry point that fires when Workable sends a webhook for subscribed candidate events. Select which event to listen for (candidate created or candidate moved) and optionally filter by a specific job or hiring stage. The raw webhook payload from Workable is passed through as the output item.

Key Notes

  • The triggerOn parameter is required and determines which type of Workable event will start the workflow
  • Filters are optional but help reduce noise by only triggering on relevant events
  • Job shortcodes can be found in the Workable job URL (the alphanumeric code after the job title)
  • Stage slugs are the URL-friendly versions of stage names (e.g., “Phone Interview” becomes “phone-interview”)
  • Both filters can be used together for precise event targeting
  • The job and stage fields must be nested inside the filters object, not placed at the top level of parameters

Frequently asked questions

Which events are available?

Candidate created and candidate moved. The triggerOn parameter is required and determines which of them starts the workflow.

Can I limit it to one job?

Yes — optionally filter by a specific job or hiring stage so the workflow only wakes for the pipeline it handles.

What does the workflow receive?

The raw webhook payload from Workable, passed through as the output item.

Which credential does it need?

A Workable credential.

Build with the Workable Trigger node

Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Workable credentials first.

Open BusyBot

Last updated . Spotted something wrong? Tell us.