> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interviewflowai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workable integration

> Connect Workable to InterviewFlowAI, automatically invite candidates by hiring stage, and sync completed interview results back to Workable.

# Set up the Workable integration

The Workable integration creates an InterviewFlowAI interview when a Candidate applies in a mapped stage or later moves into a mapped Workable stage. After the Candidate completes the interview, InterviewFlowAI adds the score, recommendation, and full report link to the Candidate's Workable timeline.

```text theme={null}
Candidate enters a mapped Workable stage
  -> InterviewFlowAI emails the interview invitation
  -> Candidate completes the interview
  -> Results appear as a comment on the Workable candidate timeline
```

## 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 Interviewer and a test Candidate with a valid name and email address.

<Warning>
  A Workable API token grants access to recruiting data. Treat it like a password. Do not send it through email or public chat.
</Warning>

## Step 1: Prepare your InterviewFlowAI Interviewer

1. Log in to the [InterviewFlowAI dashboard](https://app.interviewflowai.com).
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:

| Scope                          | Why InterviewFlowAI needs it                               |
| ------------------------------ | ---------------------------------------------------------- |
| `r_jobs`                       | Read Workable Interviewers, stages, and active members.    |
| `r_candidates`                 | Receive candidate stage-change events.                     |
| `w_candidates` or `w_comments` | Add completed interview results to the Candidate timeline. |

9. Generate the token.
10. Copy it immediately. Workable displays the complete token only once.

For Workable's token instructions, see [Generate an API access token](https://workable.readme.io/reference/generate-an-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:

```text theme={null}
https://acme.workable.com
```

your subdomain is:

```text theme={null}
acme
```

You can paste either `acme` or the complete Workable URL into InterviewFlowAI. InterviewFlowAI normalizes it automatically.

## Step 4: Connect Workable to InterviewFlowAI

1. In InterviewFlowAI, open **ATS Integration**.
2. Find **Workable** and click **Open setup**.
3. Enter your **Account subdomain**.
4. Paste your **API access token**.
5. Click **Connect**.

InterviewFlowAI validates the credentials and registers Workable webhooks for new Candidates and stage changes. A **Connected** badge appears when setup succeeds.

<Note>
  If you replace or revoke the token in Workable, return to this page and update the connection with the new token.
</Note>

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

1. In the **Candidate automation** section, click **Add mapping**.
2. Select the Workable Interviewer.
3. Select the Workable stage that should trigger the invitation.
4. Select the InterviewFlowAI Interviewer the Candidate should receive.
5. Click **Save automation**.

You can add multiple mappings for different Workable Interviewers or stages.

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. Workable sends a new-Candidate event, and InterviewFlowAI creates and emails the invitation automatically.

## Step 6: 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 Interviewer.
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.
5. Open the report link for recordings, transcripts, answers, scoring, and detailed analysis.

Moving the same Candidate through the same webhook event more than once does not create duplicate invitations. InterviewFlowAI also prevents a second active interview for the same Candidate and Interviewer.

## 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 Interviewers 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 active Interviewers and pipeline stages.

### 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 Interviewer and stage match the mapping exactly.
* The Candidate has a valid name and email.
* The mapped InterviewFlowAI Interviewer is active.
* The Candidate does not already have an active interview for the same InterviewFlowAI Interviewer.
* 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.

### 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`.
* 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](mailto:support@interviewflowai.com) with the Workable company subdomain, Candidate email, mapped stage, and approximate event time. Do not include your API token.