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

# How-to: Creating a Shareable Interview Link

## When to use this

Use this mutation when you want to create a **public link** to a candidate’s completed interview. For example:

* To share the recording with external reviewers or clients.
* To let users in your ATS watch interviews directly, without logging into Hireflix.

Each shareable link opens the Hireflix playback page for that interview, showing all candidate answers in one place.

<img src="https://mintcdn.com/hireflixsl/9JsmHoMd6qcj3iK4/images/hireflixplaybackpageoptimized.png?fit=max&auto=format&n=9JsmHoMd6qcj3iK4&q=85&s=2d63576978598b38fc23fdaa7ca2a68e" alt="Hireflixplaybackpageoptimized Pn" width="2268" height="1424" data-path="images/hireflixplaybackpageoptimized.png" />

## GraphQL Request

Replace the `interviewId` with the interview you want to share. You can find the interview ID via the guide ["List Interviews for a Position"](/features/interviews/list-interviews-for-position). Don't forget to update the [Hireflix API Key](/quickstart) in the `headers`.

<iframe src="https://cdn.hireflix.com/graphql-playground/index.html?query=ShareInterview&url=https://api.hireflix.com/me" width="100%" height="750" />

### Explanation

* `shareInterview(interviewId)` — the interview you want to share.
* `shareInterview(durationInDays: 100)` — creates a new shareable link valid for 100 days. The default is **75 days** if you omit the parameter. The minimum is 1 day.
* \`shareInterview(labels: \["ext\_firm"]) - add custom labels to the shared URLs so you can tag with whom you've shared it. This field is optional.
* `externalLink.url` (on InterviewType) — the actual public URL. Anyone with this link can view the interview without signing in. Be careful when sharing this link publicly!

<Tip>
  **Tip:** Use the `externalId` attribute when sending interview results back to your ATS or CRM system. If you passed an `externalId` when inviting a candidate, you can easily match this interview in your own database.
</Tip>

### Example Response

```json theme={null}
{
  "data": {
    "shareInterview": {
      "id": "68d4164f19367e041b2030c0",
      "externalId": "YOUR_UNIQUE_SYSTEM_ID",
      "externalLink": {
        "expires": 1790087522560,
        "owner": "68b43b275e65a4c6a828a083",
        "url": "https://shared.hireflix.com/interview/14ec14e4-4ab0-4fcd-a02e-2fa002c92124"
      }
    }
  }
}
```

### Best Practices

* **Recommended expiry:** Use at least **365 days**. Shorter durations risk breaking the link before external reviewers have time to watch.
* **Avoid long-lived links:** Extremely long or permanent links can be a **privacy risk** if leaked.

<Card color="#5863ff" icon="arrow-right" horizontal href="/features/interviews/list-interviews-for-position" title="Learn next?">
  Let's learn how to list interviews for a position.
</Card>