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

# Ashby integration

> Send AI interview invitations from Ashby and review results on the Candidate profile.

Connect Ashby to send AI interviews when Candidates enter a hiring stage. Completed scores and report links return to the Candidate profile in Ashby.

## Before you start

You need an active InterviewFlowAI Interviewer and access to manage integrations in Ashby. Ask the person who manages your Ashby account to help with connection permissions.

## Connect Ashby

1. In InterviewFlowAI, open **ATS & Integrations → Ashby → Open setup**.
2. Click **Generate API key** and copy the key immediately. It is shown in full only once.
3. Copy the URL displayed under **Staging Base URL**. Use the value shown in the setup page.

<Frame caption="Copy the API key and base URL from InterviewFlowAI.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.36.15.png" alt="InterviewFlowAI Ashby setup with the API key and Staging Base URL" />
</Frame>

4. In Ashby, open **Admin → Integrations → InterviewFlowAI**. Paste the InterviewFlowAI key and base URL into the corresponding fields.

<Frame caption="Open Integrations in Ashby.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.41.37.png" alt="Ashby Admin menu with Integrations" />
</Frame>

<Frame caption="Paste the InterviewFlowAI key and base URL in Ashby.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.44.02.png" alt="Ashby InterviewFlowAI integration fields for the API key and base URL" />
</Frame>

5. Generate an Ashby API key with the permissions below.
6. Return to InterviewFlowAI, paste the key into **Ashby API key**, and click **Connect now**. If a permission is missing, add the permission identified by the setup page.

<Frame caption="Connect Ashby in InterviewFlowAI.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.47.28.png" alt="InterviewFlowAI Ashby setup with the Ashby API key field" />
</Frame>

<Accordion title="Ashby API key permissions">
  Give this list to the person configuring your Ashby connection:

  * `jobs:read`
  * `jobs:write`
  * `candidates:read`
  * `candidates:write`
  * `interviews:read`
  * `hiringProcessMetadata:read`
  * `apiKeys:read`
</Accordion>

<Warning>
  Treat both API keys like passwords. Do not include them in screenshots or public messages.
</Warning>

## Send interviews from a hiring stage

1. In Ashby, open the job you want to connect and select **Interview Plan → Add Activity**.

<Frame caption="Add an activity to the interview plan.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.50.56.png" alt="Ashby interview plan with Add Activity" />
</Frame>

2. Select **InterviewFlowAI** under **Integrations**.

<Frame caption="Select InterviewFlowAI.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.51.40.png" alt="Ashby activity list with InterviewFlowAI under Integrations" />
</Frame>

3. Choose the assessment that corresponds to your InterviewFlowAI Interviewer and click **Add**.

<Frame caption="Choose the assessment.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2016.56.40.png" alt="Ashby assessment selection for InterviewFlowAI" />
</Frame>

4. Click **Edit** beside the activity and open **Automation**.

<Frame caption="Edit the InterviewFlowAI activity.">
  <img src="https://website-images.interviewflowai.com/docs/image.png" alt="Ashby InterviewFlowAI activity with the Edit option" />
</Frame>

<Frame caption="Open the Automation settings.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2017.00.02.png" alt="Ashby activity Automation tab" />
</Frame>

5. Select **Automate on Stage Entry → Start Assessment**.

<Frame caption="Start the assessment on stage entry.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2017.06.16.png" alt="Ashby automation set to Start Assessment on stage entry" />
</Frame>

<Frame caption="The assessment link appears on the Candidate profile.">
  <img src="https://website-images.interviewflowai.com/docs/image%20(4).png" alt="Ashby Candidate profile with the InterviewFlowAI assessment link" />
</Frame>

Test the stage with a test Candidate whose inbox you can access. Confirm that the invitation arrives before using the automation with Candidates.

## Review results

After the Candidate completes the interview and the report is ready, open their profile in Ashby. The assessment shows a completed status, score, and links to the detailed report and available interview recordings.

<Frame caption="Review results on the Candidate profile in Ashby.">
  <img src="https://website-images.interviewflowai.com/docs/Screenshot%202026-03-20%20at%2017.13.16.png" alt="Ashby Candidate profile with the completed InterviewFlowAI assessment and score" />
</Frame>

Review the interview evidence before deciding the next hiring step. For connection issues, contact [support](mailto:support@interviewflowai.com).


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