> ## 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.

# Recruit CRM integration

> Invite Candidates automatically when they reach a Recruit CRM hiring stage, get results back as a note, and move Candidates by interview score.

When a Candidate enters a mapped hiring stage on a Recruit CRM job, InterviewFlowAI sends them an interview invitation. When they finish, the score, recommendation, and report link are added as a note on their Recruit CRM profile. You can also move Candidates to a hiring stage based on their interview status or score.

## Before you start

You need:

* **Owner** access in InterviewFlowAI.
* Admin access in Recruit CRM.
* An active InterviewFlowAI Interviewer for the job.

## Set up the integration

<Steps>
  <Step title="Copy your Recruit CRM API token">
    In Recruit CRM, go to **Admin Settings** > **API & Integrations** and copy your API token.

    <Warning>Treat the token like a password. Don't share it in email or chat.</Warning>
  </Step>

  <Step title="Connect Recruit CRM">
    In InterviewFlowAI, open **ATS & Integrations**. Find **Recruit CRM** and click **Open setup**. Paste the token into **API token** and click **Connect**.

    A **Connected** badge appears. InterviewFlowAI creates the Recruit CRM webhooks for you.
  </Step>

  <Step title="Map a Recruit CRM job to an Interviewer">
    Under **Candidate automation**, click **Add mapping** and choose:

    * **Recruit CRM job**: the job Candidates are assigned to.
    * **Trigger stage**: the hiring stage that sends the invitation, such as **Screening**. To invite Candidates as soon as they're added to the job, choose the first stage, such as **Assigned**.
    * **InterviewFlowAI interviewer**: the Interviewer the Candidate takes.

    Click **Save automation**. Add one mapping for each job.
  </Step>

  <Step title="(Optional) Move Candidates when their status changes">
    Under the mapping, pick a Recruit CRM stage for any InterviewFlowAI status, such as **Interview completed**, **Declined**, or **Invite expired**. Leave a status on **Don't move** to skip it. Click **Save automation**.

    <Tip>To reject Candidates in Recruit CRM, map **Declined** and **Opted out** to your rejection stage.</Tip>
  </Step>

  <Step title="(Optional) Move Candidates by interview score">
    Under the mapping, expand **Move by interview score**. For each range, enter a **From score** and **To score** between 0 and 100, and choose a hiring stage in **Move to**. Click **Save automation**.

    For example, send 70–100 to your next interview stage, 50–69 to a review stage, and 0–49 to your rejection stage.

    * 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.
    * The stage change includes the score as a remark, for example `InterviewFlowAI: interview score 42/100`.
    * Choose the job first. The stage list comes from that job's hiring pipeline, and changing the job clears the stages you picked.
  </Step>

  <Step title="Test with one Candidate">
    Move a test Candidate with your own email address into the trigger stage. Check that the invitation arrives, complete the interview, then open the Candidate's **Notes** in Recruit CRM to see the result.
  </Step>
</Steps>

## Good to know

* Each Candidate gets one interview per Interviewer. Moving them into the stage again doesn't send a second invitation.
* Candidates already in the trigger stage before you save the mapping aren't invited. Move them out of the stage and back in.
* When a Candidate completes a retake, InterviewFlowAI moves them again based on the new score.
* If resume screening is on for the Interviewer, the Candidate's Recruit CRM resume is screened first. PDF and DOCX files up to 5 MB are supported.
* The job list shows your first 500 Recruit CRM jobs.
* If you replace your Recruit CRM token, paste the new one and click **Update connection**.

## Troubleshooting

| Problem | What to check |
| - | - |
| Token won't connect | Copy the full token with no spaces. If you see a rate limit message, wait one minute and try again. |
| No invitation sent | The mapping was saved before the move, the job and stage match, and the Candidate has an email address. Check spam too. |
| No note in Recruit CRM | The report has finished processing in InterviewFlowAI. Refresh the Candidate's profile. |
| Candidate not moved after the interview | The score falls inside one of your ranges, or **Interview completed** has a stage. You saved the mapping, and the stage still exists in the job's hiring pipeline. |

Still stuck? Email [support@interviewflowai.com](mailto:support@interviewflowai.com) with the job name and Candidate email. Don't include your API token.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.