Workable
API actions for the Workable integration.
Workable
Manage recruiting workflows with Workable's hiring platform.
Add a candidate note
Attach an internal note to a Workable candidate profile.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
candidate_id | string | Yes | The Workable candidate ID to annotate. |
note | string | Yes | Note text to attach to the candidate. |
visibility | string | No | Optional visibility scope (e.g., internal). |
Response
{
"comment": "mock_value",
"comment_id": "mock_value",
"status": "mock_value"
}Advance candidate stage
Move a candidate to a new pipeline stage in Workable.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
candidate_id | string | Yes | The Workable candidate ID to move. |
stage | string | Yes | Target pipeline stage slug (e.g., screening, offer). |
reason | string | No | Optional reason for the stage change. |
Response
{
"candidate_id": "mock_value",
"stage": "mock_value",
"status": "mock_value"
}Create a candidate
Add a candidate to a Workable job with contact details and optional resume link.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_shortcode | string | Yes | The Workable job shortcode to attach the candidate to. |
name | string | Yes | Full name of the candidate. |
email | string | Yes | Candidate email address. |
phone | string | No | Optional phone number for the candidate. |
resume_url | string | No | Optional URL to the candidate's resume file. |
cover_letter | string | No | Optional cover letter text for the candidate. |
headline | string | No | Optional headline or summary for the candidate. |
Response
{
"candidate": "mock_value",
"candidate_id": "mock_value",
"status": "mock_value"
}Get candidate details
Fetch the full profile for a Workable candidate by ID.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
candidate_id | string | Yes | The Workable candidate ID to fetch. |
Response
{
"candidate": "mock_value",
"status": "mock_value"
}Get job details
Fetch detailed information about a specific Workable job using its shortcode.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
job_shortcode | string | Yes | The Workable job shortcode to retrieve. |
Response
{
"job": "mock_value",
"status": "mock_value"
}List open jobs
Retrieve jobs from Workable with optional state filtering.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
state | string | No | Optional job state to filter by (e.g., published, archived). |
include_fields | array | No | Optional list of extra fields to include (comma-joined server-side). |
Response
{
"jobs": [
{}
],
"status": "mock_value",
"total": 1
}