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.

GraphQL Request

Replace the interview ID with the interview you want to share. You can find the interview ID via the guide “List Interviews for a Position”. Don’t forget to update the Hireflix API Key in the headers.

Explanation

• Interview(id) — the interview you want to share.
• share(durationInDays: 100) — creates a new shareable link valid for 100 days. The default is 75 days if you omit the parameter.
• externalLink.url — the actual public URL. Anyone with this link can view the interview without signing in. Be careful when sharing this link publicly!

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

{
  "data": {
    "Interview": {
      "share": {
        "externalId": "YOUR_SYSTEM_ID",
        "externalLink": {
          "url": "https://shared.hireflix.com/interview/b1a00e3f-3188-4191-8923-b5aba36f719a"
        }
      }
    }
  }
}

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.

Learn next?

Let’s learn how to list interviews for a position.