Skip to main content
The Workable integration creates an InterviewFlowAI interview when a Candidate applies to a mapped Workable job in a mapped stage, or later moves into that stage. After the Candidate completes the interview, InterviewFlowAI adds the score, recommendation, and full report link to the Candidate’s Workable timeline. You can also have InterviewFlowAI move Candidates to a Workable stage based on their interview status or score.

​
Before you start

Make sure you have:
  • Owner access in InterviewFlowAI.
  • Permission to generate API tokens in Workable.
  • At least one active, non-archived InterviewFlowAI Interviewer.
  • A Workable job and a test Candidate with a valid name and email address.
A Workable API token grants access to recruiting data. Treat it like a password. Do not send it through email or public chat.

​
Step 1: Prepare your InterviewFlowAI Interviewer

  1. Log in to the InterviewFlowAI dashboard.
  2. Create or open the Interviewer you want to use with Workable.
  3. Confirm the Interviewer is active and not archived.
  4. Review its questions, evaluation criteria, language, expiration period, and invitation email.
Only active InterviewFlowAI Interviewers appear while creating a Workable mapping.

​
Step 2: Generate a Workable API token

  1. Log in to Workable.
  2. Open the menu in the upper-right corner.
  3. Select Settings.
  4. Under Integrations, click Apps.
  5. Click API access tokens.
  6. Click Generate new token.
  7. Give the token a clear name, such as InterviewFlowAI.
  8. Enable these scopes:
  1. Generate the token.
  2. Copy it immediately. Workable displays the complete token only once.
For Workable’s token instructions, see Generate an API access token.

​
Step 3: Find your Workable subdomain

Open your Workable company profile settings and copy the account subdomain. For example, if your Workable URL is:
your subdomain is:
You can paste either acme or the complete Workable URL into InterviewFlowAI. The field accepts either format.

​
Step 4: Connect Workable to InterviewFlowAI

  1. In InterviewFlowAI, open ATS & Integrations in the sidebar.
  2. Find Workable and click Open setup.
  3. Enter your Account subdomain.
  4. Paste your API access token.
  5. Click Connect.
A Connected badge appears when setup succeeds. InterviewFlowAI can then invite Candidates at the stages you map.
If you replace or revoke the token in Workable, return to this page and update the connection with the new token.

​
Step 5: Map a Workable stage to an InterviewFlowAI Interviewer

  1. In the Candidate automation section, click Add mapping.
  2. Select the Workable job.
  3. Select the Trigger stage that should send the invitation.
  4. Select the InterviewFlowAI interviewer the Candidate should receive.
  5. Click Save automation.
You can add multiple mappings for different Workable jobs or stages. The Workable job list shows up to your first 100 Workable jobs. If resume screening is turned on for the mapped Interviewer, InterviewFlowAI screens the Candidate’s Workable resume first. A Candidate who doesn’t pass screening is marked as declined and doesn’t receive an invitation. Choose a stage that candidates enter only when they should receive the interview. Common choices are Phone Screen, Assessment, or a custom assessment stage. To invite Candidates immediately after they apply, select Workable’s Applied stage. InterviewFlowAI sends an invitation when a new Candidate applies to the mapped job.

​
Step 6: (Optional) Move Candidates automatically

InterviewFlowAI can move Candidates to a Workable stage as their interview progresses. You set this up per mapping. Your token needs the w_candidates scope.

​
Move by status

  1. Under the mapping, expand Sync status to Workable.
  2. Pick a Workable stage for any InterviewFlowAI status, such as Interview completed or Invite expired. Leave a status on Don’t move to skip it.
  3. Click Save automation.
Declined and opted-out Candidates are always disqualified in Workable, even if you don’t pick a stage for them.

​
Move by interview score

Use score ranges to sort Candidates after the interview. For example, advance strong Candidates, hold borderline ones for review, and disqualify the rest.
  1. Under the mapping, expand Move by interview score.
  2. For each range, enter a From score and To score between 0 and 100.
  3. In Move to, choose the Workable stage for that range.
  4. To also disqualify Candidates in that range, select Also disqualify.
  5. Click Save automation.
For example: How score ranges work:
  • You can set up to three ranges. Each range includes both ends, so 50–69 and 70–100 don’t overlap.
  • Ranges can’t overlap. InterviewFlowAI won’t save overlapping ranges.
  • A score inside a range overrides the Interview completed stage. A score outside every range uses the Interview completed stage, if you set one.
  • Disqualified Candidates stay in the stage you chose. The disqualification note shows the score, for example InterviewFlowAI: interview score 42/100.
  • When a Candidate completes a retake, InterviewFlowAI moves them again based on the new score. If the new score is outside a disqualify range, InterviewFlowAI removes the disqualification.

​
Step 7: Test the integration

Test one Candidate before enabling the workflow for your hiring team.
  1. Create or choose a test Candidate in the mapped Workable job.
  2. Confirm the Candidate has a name and valid email address.
  3. Move the Candidate into the mapped stage.
  4. Check the Candidate’s inbox for the InterviewFlowAI invitation.
  5. Open InterviewFlowAI and confirm the Candidate appears under the mapped Interviewer.
  6. Complete the interview as the test Candidate.
  7. Wait for InterviewFlowAI to finish generating the report.
  8. Refresh the Candidate profile in Workable.
The Workable timeline comment should contain:
  • The InterviewFlowAI completion status.
  • The overall score out of 100, when available.
  • The recommendation, when available.
  • A link to the complete InterviewFlowAI report.

​
Day-to-day workflow

After setup, Owners and Viewers continue managing the pipeline in Workable:
  1. Move a Candidate into a mapped stage.
  2. InterviewFlowAI creates one interview and sends the invitation email.
  3. The Candidate completes the interview without needing a Workable account.
  4. InterviewFlowAI posts the result to the Candidate timeline and moves the Candidate, if you set up automatic moves.
  5. Open the report link for recordings, transcripts, answers, scoring, and detailed analysis.
If a Candidate already has an interview under the same InterviewFlowAI Interviewer, the integration doesn’t create another invitation. Check the existing record before trying to invite them again.

​
Troubleshooting

​
Workable does not connect

Check that:
  • The subdomain belongs to the same Workable company that generated the token.
  • You pasted the complete token without spaces.
  • The token has r_jobs and r_candidates scopes.
  • The token has not been revoked.
  • Workable has at least one active member.
Generate a new token and reconnect if the original token is unavailable.

​
Workable connects, but no jobs or stages appear

Refresh the setup page. If the lists remain empty, confirm the token has r_jobs access and that the Workable account has jobs and pipeline stages. Only the first 100 Workable jobs are listed.

​
An InterviewFlowAI Interviewer does not appear

Confirm the Interviewer belongs to the current InterviewFlowAI company and is not archived.

​
The Candidate did not receive an invitation

Check that:
  • You saved the mapping before moving the Candidate.
  • The Workable job and stage match the mapping.
  • The Candidate has a valid name and email.
  • The mapped InterviewFlowAI Interviewer is active.
  • The Candidate doesn’t already have an interview, in any status, for the same InterviewFlowAI Interviewer.
  • The Candidate wasn’t declined by resume screening.
  • The invitation did not land in spam or promotions.
If the Candidate was already in the stage before you saved the mapping, move the Candidate out of that stage and back into it.

​
The Candidate was not moved in Workable

Check that:
  • The token has w_candidates access.
  • You saved the mapping after setting the stages.
  • The interview score falls inside one of your ranges, or Interview completed has a stage.
  • The stage still exists in Workable.
Score ranges apply only after the interview is completed and scored.

​
Results do not appear in Workable

Check that:
  • The InterviewFlowAI report has finished processing.
  • The token has w_candidates or w_comments access.
  • The token has not been revoked since the invitation was sent.
  • You refreshed the Candidate profile in Workable.
The result-sync failure does not remove the completed report from InterviewFlowAI. You can still open the report from the InterviewFlowAI dashboard.

​
Security and token rotation

  • Create a dedicated Workable token for InterviewFlowAI.
  • Grant only r_jobs, r_candidates, and either w_candidates or w_comments. Use w_candidates if InterviewFlowAI moves Candidates for you.
  • Never place the token in source code, screenshots, tickets, or shared documents.
  • Revoke the token in Workable if it is exposed.
  • Reconnect InterviewFlowAI immediately after generating a replacement token.

​
Get help

Contact support@interviewflowai.com with the Workable company subdomain, Candidate email, mapped stage, and approximate event time. Do not include your API token.