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

# Custom integrations

> Plan a custom connection that invites Candidates and keeps hiring records in sync.

A custom integration connects InterviewFlowAI to a hiring tool that doesn't have a built-in connector. Your technical team sets up the connection. You decide which Interviewers, Candidates, and hiring steps it should use.

Start with a [built-in ATS integration](/platform/integrations) or [Zapier](/platform/zapier-integration) when it covers your workflow.

## What you can automate

| Recruiting task | Result |
| - | - |
| Create or update Interviewers | Keep role details and interview settings aligned with your hiring system. |
| Invite Candidates | Send interview invitations from your ATS or another tool. |
| Retrieve interview results | Bring scores, reports, and Candidate progress into your own system. |
| Update Candidate records | Keep notes, custom stages, and additional fields in sync. |
| Receive event updates | Notify another tool when an interview starts, ends, or has a report ready. See [Webhooks](/platform/webhooks). |

## Prepare the handoff

1. Choose the Interviewers and hiring stages the integration should use.
2. Decide when Candidates should receive invitations.
3. List the information you need to send or receive, such as Candidate details, scores, and report links.
4. Confirm that your plan includes API access. Contact [support](mailto:support@interviewflowai.com) if you're unsure.
5. Ask an **Owner** to create an [API key](/platform/api-keys) and share it securely with your technical team.
6. Ask your technical team or InterviewFlowAI support for the API implementation reference.

## Test the hiring workflow

Use a test Candidate and an inbox you control. Confirm that the Candidate receives the correct invitation, appears under the intended Interviewer, and has results in the destination tool after completion.

<Warning>
  Invitations sent during a test are real emails. Use test records before enabling the integration for Candidates.
</Warning>


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