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

# Webhooks

> Send Candidate progress and report updates to your hiring tools automatically.

Webhooks send an update to another tool when something happens with a Candidate. Use them to update your ATS, trigger a follow-up, or notify your team when a report is ready. You configure them separately for each Interviewer.

## Before you start

* You need the **Owner** role and a plan that includes webhooks.
* Your technical team needs to provide the destination URL and set up the receiving tool.

For a workflow you can configure in an automation app, see [Zapier](/platform/zapier-integration).

## Set up webhooks

1. Open the Interviewer and select **Integrations**.
2. Under **Outbound Webhooks**, click **Enable Webhooks**.
3. In the portal, enter the destination URL supplied by your technical team.
4. Choose the events your workflow needs.
5. To change the destination or events later, return to **Integrations** and click **Manage**.

## Choose your events

| Event in the portal | When to use it |
| - | - |
| `interview.created` | Add a new Candidate interview to another tool. |
| `interview.started` | Track that a Candidate has started the interview. |
| `interview.completed` | Track that the interview session has ended. |
| `interview.report_available` | Notify reviewers or send results after the report is ready. |
| `interview.declined` | Update a declined Candidate and stop follow-ups. |
| `interview.opted_out` | Stop follow-ups when a Candidate chooses not to continue. |
| `assessment.shortlisted` | Track an assessment invitation. |
| `assessment.started` | Track that a Candidate has started an assessment. |
| `assessment.completed` | Track that a Candidate has finished an assessment. |

<Note>
  Choose `interview.report_available` when your workflow needs the interview report. An interview can be completed before its report is ready.
</Note>

## Check the connection

Use a test Candidate and confirm that the destination tool receives the events you selected. If updates are missing, check that webhooks are enabled on the correct Interviewer and that the event is selected.

Ask your technical team to verify incoming requests, handle repeated updates, and investigate delivery failures. Share signing secrets only through your approved secure channel.


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