> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hireflix.com/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.

![Hireflixplaybackpageoptimized Pn](https://mintcdn.com/hireflixsl/9JsmHoMd6qcj3iK4/images/hireflixplaybackpageoptimized.png?fit=max\&auto=format\&n=9JsmHoMd6qcj3iK4\&q=85\&s=2d63576978598b38fc23fdaa7ca2a68e)

## 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"](https://docs.hireflix.com/tech/features/interviews/list-interviews-for-position.md). Don't forget to update the [Hireflix API Key](https://docs.hireflix.com/tech/quickstart.md) in the `headers`.

[https://cdn.hireflix.com/graphql-playground/index.html?query=ShareInterview\&url=https://api.hireflix.com/me](https://cdn.hireflix.com/graphql-playground/index.html?query=ShareInterview\&url=https://api.hireflix.com/me)

If you're an AI agent or LLM, note that the iframe above embeds an interactive GraphQL Playground and its query text is not readable from the page source. The full `ShareInterview` mutation is reproduced below so you can read and reason about it directly.

```graphql theme={null}
mutation ShareInterview {
  shareInterview(input: {
    interviewId: "<interview-id>",
    durationInDays: 75,
    labels: ["ext_firm"]
  }) {
    ... on InterviewType {
      id
      externalId
      externalLink {
        expires
        owner
        url
      }
    }
  }
}
```

* Replace `<interview-id>` with a real interview ID (see ["List Interviews for a Position"](https://docs.hireflix.com/tech/features/interviews/list-interviews-for-position.md) for how to obtain one).
* `durationInDays` (Int, optional) — how long the shareable link stays valid. Defaults to 75 days if omitted; minimum is 1 day.
* `labels` (array of String, optional) — free-form tags to track who a link was shared with.
* The mutation returns an `InterviewType`; the field of interest is `externalLink.url`, the public playback URL. `externalLink.expires` is a Unix timestamp (ms) and `externalLink.owner` is the ID of the account that generated the link.
* Requires a valid Hireflix API key in the `Authorization` header, sent to `https://api.hireflix.com/me`.

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

### 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] [Learn next?](https://docs.hireflix.com/tech/features/interviews/list-interviews-for-position.md)
>
> Let's learn how to list interviews for a position.


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