Integrations

Connect Hirevalu to Workable

Add a Hirevalu stage in Workable, activate the integration with an API key, and link a job so candidates are invited and results sync back automatically.

Updated
Connecting Workable end to end — from the pipeline stage to a linked agent.

Connecting Workable turns a single pipeline move into a screening interview. Drag a candidate into the Hirevalu stage in Workable and they are invited to a Hirevalu interview automatically; once they finish, the evaluation is pushed back to Workable, so your team never has to leave the ATS.

Setup takes three steps in the integration guide, then one more on each agent you want to sync.

Before you start

  • You need a Workable account with permission to edit the recruiting pipeline and create API access tokens — usually an admin.
  • Have your Workable subdomain to hand: the your-company part of your-company.workable.com.
  • Only one ATS can be linked to an agent. Choosing Workable on an agent clears any Lever link on it, and vice versa.

1. Open the Workable integration guide

In Hirevalu, go to Account settings → Integrations → ATS. Expand the Workable card and click Connect Workable (or the Integration guide badge — both open the same guide).

The guide walks you through three steps, with a checklist on the left that ticks off as you go.

The Workable Integration Guide in Hirevalu, showing step 1 to create the Hirevalu stage and step 2 to generate an API key
Hirevalu → Account settings → Integrations → ATS → Workable → Integration guide

2. Create the “Hirevalu” stage in Workable

In Workable, go to Settings → Recruiting → Workflow. Under Pipelines, click Edit next to Recruiting pipeline, then add a stage named exactly Hirevalu and save.

Workable settings with Workflow selected in the sidebar and the Edit link next to Recruiting pipeline highlighted, showing a Hirevalu stage between Applied and Phone Screen
Workable → Settings → Recruiting → Workflow → Recruiting pipeline → Edit

Placement matters: every candidate moved into this stage is invited to a Hirevalu interview, so put it where your process would otherwise hand off to a first-pass screen — right after Applied works well for most teams.

Back in the guide, tick I’ve created the “Hirevalu” stage in Workable.

If you use more than one pipeline (for example, per department or location), add the Hirevalu stage to each pipeline used by a job you plan to link.

3. Generate a Workable API key

In Workable, go to Settings → Integrations → Apps. Scroll to API access tokens and click Generate API token.

Workable settings with Integrations → Apps selected in the sidebar and the Generate API token button highlighted in the API access tokens section
Workable → Settings → Integrations → Apps → API access tokens

In the Generate API token dialog:

  1. Name — something your team will recognise later, such as Hirevalu.
  2. Expires in — pick how long the token stays valid. When it expires, the integration stops syncing until you generate a new key.
  3. API scopes — tick exactly these four:
ScopeWhy Hirevalu needs it
r_jobsList your jobs so you can link them to agents
r_candidatesSee which candidates enter the Hirevalu stage
w_candidatesUpdate candidates in Workable with their interview progress
w_commentsPost the interview evaluation back to the candidate
The Generate API token dialog in Workable with Name, Expires in, and the API scopes checklist
Name the token, set an expiry, and select the four scopes

Click Generate token and copy the key straight away — Workable only shows it once.

Need a hand? See Workable’s API token docs.

4. Paste your key to go live

Back in the guide, fill in step 3:

  • Account subdomain — just the subdomain; .workable.com is added for you.
  • API key — the token you copied in the previous step.

Click Activate integration. Hirevalu verifies the key, and the guide confirms Integration is now live. Your key is stored encrypted and only used to sync jobs and candidates.

Step 3 of the Workable Integration Guide with the account subdomain and API key fields and the Activate integration button
Enter your subdomain and API key, then activate

The Workable card now shows Connected, and its main button changes to Manage connection.

The Workable card in Hirevalu account settings showing a Connected status and the Manage Connection button
A connected Workable account

Connecting the account doesn’t sync anything on its own — you choose which agents are linked, one Workable job each.

Create your agent (see Create your first position) and open the ATS integration step. Select Workable, switch on Sync with Workable, then pick the job to link. Use Search Workable jobs to filter by name, or View to open the posting in Workable and double-check it’s the right one.

The ATS integration step of the Hirevalu agent builder with Workable selected, Sync with Workable switched on, and a list of Workable jobs
Hirevalu → Create agent → ATS integration → Workable

Once linked, the integration will:

  • Invite automatically — candidates moved into the “Hirevalu” stage for that job are sent a screening invitation
  • Sync results back — when the interview is complete, the evaluation is pushed to the candidate in Workable

Managing the connection

Click Manage connection on the Workable card to open Linked positions. It shows the connected account, the invite stage, and every Hirevalu agent linked to a Workable job — with how many candidates have synced, when it last synced, and whether each link is Syncing or Paused.

The Linked Positions dialog listing Hirevalu agents paired with Workable jobs, with synced candidate counts and sync status
Account settings → Integrations → ATS → Workable → Manage connection
  • Reopen the guide — use Integration guide at the bottom of the dialog.
  • Disconnect — open the integration guide and click Disconnect Workable.
  • Change an agent’s job — the Workable link is set when the agent is created and can’t be changed from Edit agent yet.

Troubleshooting

SymptomLikely cause
“That API key looks too short”The key was only partly copied — generate a new token and paste the whole thing
No Workable jobs appear in the pickerWorkable isn’t connected yet (step 4), or the account has no published jobs
Candidates aren’t being invitedThe stage isn’t named exactly Hirevalu (step 2), or the agent isn’t linked to that job (step 5)
No Workable jobs appear in the pickerThe token is missing r_jobs (step 3) — generate a new one with all four scopes
Results aren’t appearing in WorkableThe token is missing w_comments or w_candidates (step 3), or the interview isn’t complete yet
Sync stopped working after a whileThe API token expired — generate a new key and reconnect

If a job still doesn’t appear after connecting, confirm it’s published in Workable and not still a draft.